Τεκμηρίωση για προγραμματιστές

Κάθε αίτημα πιστοποιείται με ένα μυστικό κλειδί στην κεφαλίδα «Authorization», χρησιμοποιώντας το σχήμα «Bearer».

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

Εάν τα κλειδιά API σας δημιουργούν λογαριασμούς διαφημιζόμενων για τους δικούς σας χρήστες (λειτουργία «Connect» — βλ. «Αυθεντικοποίηση» παραπάνω), κερδίζετε ένα ποσοστό από τα ποσά που πληρώνουν οι διαφημιζόμενοι αυτοί για τις διαφημίσεις τους. Η παρακάτω κατανομή διαβάζεται σε πραγματικό χρόνο από αυτό ακριβώς το endpoint, δεν είναι ποτέ προγραμματισμένη σταθερά και είναι εντελώς ξεχωριστή από την προμήθεια παραπομπής που αναφέρεται πιο κάτω σε αυτή τη σελίδα.

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

Πώς λειτουργεί

1. Ένας από τους διαφημιζόμενους σας στη λειτουργία «Connect» πληρώνει για μια διαφήμιση μέσω της ενσωμάτωσής σας.
2. Η διαφήμιση ελέγχεται και εγκρίνεται — είτε αυτόματα, είτε από την ομάδα ελέγχου περιεχομένου μας.
3. Το μερίδιό σας έχει μπει στην ουρά για αυτόματη πληρωμή στο πορτοφόλι σας, με τον ίδιο μηχανισμό όπως και στο παρακάτω πρόγραμμα συστάσεων.

Όροι πληρωμής

• Έχει ρυθμιστεί ένα πορτοφόλι πληρωμών κρυπτονομισμάτων στον λογαριασμό συνεργάτη σας.
• Δεν απαιτείται καμία διαδικασία KYC από την πλευρά σας — ο λογαριασμός συνεργάτη σας έχει ήδη ελεγχθεί κατά τη δημιουργία του.

Παράδειγμα: ανάγνωση των συσσωρευμένων μεριδίων

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

Κάθε λογαριασμός διαφημιζόμενου διαθέτει μια σειρά ενσωματωμένων εργαλείων τεχνητής νοημοσύνης — έναν δημιουργό περιεχομένου και οπτικών στοιχείων διαφημίσεων, έναν βοηθό συνομιλίας, έναν σύμβουλο προϋπολογισμού και έναν εξωτερικό ελεγκτή SEO — τα οποία χρεώνονται με πιστώσεις τεχνητής νοημοσύνης, επιπλέον της ετήσιας κατ’ αποκοπή τιμής.

Παράδειγμα — δημιουργία περιεχομένου διαφήμισης

Η ίδια κατηγορία και περιγραφή δραστηριότητας τροφοδοτούν επίσης τον παρακάτω δημιουργό εικόνων.

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

Δημιουργήστε ένα αντίστοιχο γραφικό για την ίδια διαφήμιση:

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

Τοποθετήστε μια έτοιμη διαφημιστική ενότητα στον ιστότοπό σας — χωρίς να χρειαστεί να τη δημιουργήσετε και χωρίς iframe. Το σενάριο εμφανίζεται απευθείας στη σελίδα μέσα σε ένα απομονωμένο Shadow DOM, οπότε τα στυλ του δεν επηρεάζουν ποτέ τον ιστότοπό σας, ενώ τα στυλ του ιστότοπού σας δεν επηρεάζουν ποτέ το δικό του.

Πρόσθεσέ το στη σελίδα σου

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Από προεπιλογή, εδώ εμφανίζεται η πλήρης δημόσια κατάταξη για την κατηγορία — όλοι οι διαφημιζόμενοι στην πλατφόρμα, όχι μόνο εκείνοι που έχετε προσθέσει εσείς. Για να εμφανίσετε μόνο τις διαφημίσεις από διαφημιζόμενους που δημιουργήσατε μέσω της λειτουργίας «Connect» (αυτοί που σας αποφέρουν το μερίδιό σας), προσθέστε το στοιχείο «data-partner» με τον κωδικό συνεργάτη σας (θα τον βρείτε στη σελίδα «Developers» του δικού σας πίνακα ελέγχου):

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Εάν οι διαφημιζόμενοί σας καλύπτουν διάφορες κατηγορίες, παραλείψτε εντελώς το «data-category» — χρησιμοποιώντας μόνο το «data-partner», το widget εμφανίζει όλες τις διαφημίσεις σας από όλες τις κατηγορίες σε ένα πλέγμα, αντί να απαιτείται ένα μπλοκ widget για κάθε κατηγορία:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Θέλετε να εμφανίζεται μια μονάδα τύπου υποσέλιδου παράλληλα με αυτή που βρίσκεται μέσα στο περιεχόμενο, με κάθε μία να προβάλλει διαφορετικές διαφημίσεις; Προσθέστε ένα δεύτερο μπλοκ widget με το data-layout="compact" (μία μόνο διαφήμιση, που μπορεί να συμπτυχθεί σε ένα μικρό «χάπι») και το data-offset ρυθμισμένο στον αριθμό των διαφημίσεων που εμφανίζει ήδη το πρώτο σας widget:

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Χαρακτηριστικά

Πώς καταβάλλεται στην πραγματικότητα η προμήθεια σύστασης σε έναν συνεργάτη — το ποσοστό, ο μηχανισμός πληρωμής και οι προϋποθέσεις.

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

Όροι πληρωμής

• Τα συνολικά πληρωτέα έσοδα του διαφημιζόμενου φτάνουν το ελάχιστο όριο πληρωμής.
• Στον λογαριασμό τους έχει ρυθμιστεί ένα πορτοφόλι για την είσπραξη κρυπτονομισμάτων.
• Η κατάσταση KYC τους έχει επαληθευτεί.

Παράδειγμα: ανάγνωση των συσσωρευμένων κερδών

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

Κατηγορίες τιμών (εν ενεργεία)

Διαβάστε τις τιμές ζωντανά από αυτό το σημείο τερματισμού — μην καθορίζετε ποτέ αυτές τις τιμές σταθερά, καθώς ενδέχεται να αλλάξουν από την πλευρά μας. Δημιουργήστε ένα εργαλείο επιλογής πακέτων για τους δικούς σας χρήστες αντί για ένα πεδίο ελεύθερου ποσού: κάθε τιμή που εμφανίζεται είναι ήδη το ακριβές ποσό που πρέπει να αποσταλεί κατά τη δημιουργία της πληρωμής, και τα προνόμια που εμφανίζονται εδώ ενημερώνουν τους χρήστες ακριβώς τι τους προσφέρει η συγκεκριμένη τιμή, ώστε να επιλέγουν μια τιμή που κατανοούν αντί να μαντεύουν ένα αριθμό.

Υπάρχει ανώτατο όριο αιτήσεων ανά κλειδί, ανά λεπτό. Κάθε πιστοποιημένη απόκριση περιλαμβάνει τις κεφαλίδες X-RateLimit-Limit, X-RateLimit-Remaining και X-RateLimit-Reset· σε περίπτωση υπέρβασης του ορίου, επιστρέφεται ο κωδικός κατάστασης 429 Too Many Requests με την κεφαλίδα Retry-After.

Προαιρετικό, ανά συνεργάτη. Μέχρι να προσθέσετε μια καταχώριση, τα κλειδιά σας δέχονται αιτήματα από οποιαδήποτε διεύθυνση IP — η πρώτη καταχώριση αλλάζει όλα τα κλειδιά αυτού του συνεργάτη ώστε να δέχονται αιτήματα μόνο από τη λίστα επιτρεπόμενων διευθύνσεων.

Κάθε webhook υπογράφεται με HMAC-SHA256 χρησιμοποιώντας ένα μυστικό κλειδί που εκδίδεται μία φορά, κατά τη δημιουργία του — επαληθεύστε την υπογραφή πριν εμπιστευτείτε το περιεχόμενο. Τα συμβάντα παραδίδονται μόνο στον συνεργάτη στον οποίο ανήκει ο σχετικός διαφημιζόμενος.