Documentație pentru dezvoltatori

Fiecare solicitare este autentificată cu o cheie secretă din antetul „Authorization”, utilizând schema „Bearer”.

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

Dacă cheile tale API creează conturi de advertiser pentru propriii tăi utilizatori (modul Connect — vezi secțiunea „Autentificare” de mai sus), vei primi un procent din suma pe care acești advertiseri o plătesc pentru anunțurile lor. Procentajul de mai jos este citit în timp real de la același punct de acces, nu este niciodată codificat fix și este complet separat de comisionul de recomandare prezentat mai jos pe această pagină.

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

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

Cum funcționează

1. Unul dintre agenții de publicitate din modul „Connect” plătește pentru un anunț prin intermediul integrării tale.
2. Anunțul este verificat și aprobat — automat sau de către echipa noastră de moderare.
3. Cota ta se află în așteptare pentru a fi transferată automat în portofelul tău, conform aceluiași mecanism ca și în cazul programului de recomandări de mai jos.

Condiții de plată

• În contul dvs. de partener este configurat un portofel pentru plăți în criptomonede.
• Nu este necesară nicio procedură KYC din partea ta — contul tău de partener a fost deja verificat la momentul creării.

Exemplu: citirea acțiunilor acumulate

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
}

Fiecare cont de advertiser beneficiază de un set de instrumente AI integrate — un generator de conținut și elemente vizuale pentru reclame, un asistent conversațional, un consilier în materie de buget și un auditor SEO extern — plătite cu credite AI, pe lângă tariful anual fix.

Exemplu — generarea conținutului publicitar

Aceeași categorie și aceeași descriere a activității stau la baza generatorului de imagini de mai jos.

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
}

Generați un element vizual corespunzător pentru același anunț:

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
}

Plasează un bloc publicitar gata pregătit pe site-ul tău — fără etape de creare, fără iframe. Scriptul se afișează direct în pagină, într-un Shadow DOM izolat, astfel încât stilurile sale nu se transferă niciodată în site-ul tău, iar stilurile site-ului tău nu se transferă niciodată în acesta.

Adaugă-l pe pagina ta

<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>

În mod implicit, se afișează clasamentul public complet pentru categoria respectivă — toți agenții de publicitate de pe platformă, nu doar cei pe care i-ai adus tu. Pentru a afișa doar anunțurile agenților de publicitate pe care i-ai creat prin modul Connect (cei care îți generează comisionul), adaugă „data-partner” împreună cu ID-ul tău de partener (îl găsești pe pagina „Developers” din propriul tău panou de control):

<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>

Dacă anunțatorii tăi acoperă mai multe categorii, renunță complet la „data-category” — folosind doar „data-partner”, widgetul afișează toate anunțurile tale din toate categoriile într-o singură grilă, în loc să fie nevoie de un bloc de widget pentru fiecare categorie:

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

Vrei să ai un modul de tip „footer” alături de cel din conținut, fiecare afișând reclame diferite? Adaugă un al doilea bloc de widget cu atributul data-layout="compact" (o singură reclamă, care poate fi redusă la o „pilulă” mică) și setă atributul data-offset la numărul de reclame pe care le afișează deja primul tău 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>

Atribute

Cum ajunge efectiv la un partener comisionul de recomandare — procentul, mecanismul de plată și condițiile prealabile.

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
}

Condiții de plată

• Veniturile totale de încasat ale agentului de publicitate ating suma minimă de plată.
• În contul lor este configurat un portofel pentru plăți în criptomonede.
• Statutul lor KYC este verificat.

Exemplu: citirea profiturilor acumulate

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
}

Niveluri de preț (în vigoare)

Citește valorile în timp real de la acest punct de acces — nu introduce niciodată aceste valori în mod static, deoarece ele se pot modifica din partea noastră. Creați un selector de niveluri pentru utilizatorii dvs. în locul unui câmp pentru suma liberă: fiecare preț afișat reprezintă deja suma exactă care trebuie trimisă la efectuarea plății, iar beneficiile deblocate afișate aici le indică utilizatorilor exact ce primesc în schimbul acelui preț, astfel încât aceștia să aleagă un preț pe care îl înțeleg, în loc să ghicească o sumă.

Numărul de solicitări este limitat pe cheie, pe minut. Fiecare răspuns autentificat conține anteturile X-RateLimit-Limit, X-RateLimit-Remaining și X-RateLimit-Reset; depășirea limitei generează codul de eroare 429 Too Many Requests, împreună cu antetul Retry-After.

Opțional, pentru fiecare partener. Până când adaugi o intrare, cheile tale acceptă solicitări de la orice adresă IP — prima intrare comută toate cheile acelui partener în modul „numai lista de permisiuni”.

Fiecare webhook este semnat cu HMAC-SHA256 folosind un secret generat o singură dată, la momentul creării — verificați semnătura înainte de a considera încredibil conținutul. Evenimentele sunt transmise numai partenerului care deține advertiserul respectiv.