Dokumentácia pre vývojárov

Každá požiadavka sa overuje pomocou tajného kľúča v hlavičke „Authorization“ s využitím schémy „Bearer“.

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

Ak vaše API kľúče vytvárajú reklamné účty pre vašich vlastných používateľov (režim Connect – pozri časť „Overovanie“ vyššie), získavate podiel z čiastok, ktoré títo inzerenti platia za svoje reklamy. Nižšie uvedené rozdelenie sa načíta v reálnom čase z tohto istého koncového bodu, nikdy nie je pevne zakódované a je úplne oddelené od provízie za odporúčanie, ktorá je uvedená nižšie na tejto stránke.

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

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

Ako to funguje

1. Jeden z vašich inzerentov v režime Connect zaplatí za reklamu prostredníctvom vašej integrácie.
2. Inzerát je skontrolovaný a schválený – buď automaticky, alebo našim tímom moderátorov.
3. Váš podiel je zaradený do fronty na automatickú výplatu do vašej peňaženky, a to rovnakým spôsobom ako v prípade nižšie uvedeného referenčného programu.

Podmienky výplaty

• Na vašom partnerskom účte je nastavená peňaženka na výplatu kryptomien.
• Z vašej strany nie je potrebné žiadne overenie totožnosti (KYC) – váš partnerský účet bol overený už pri jeho vytvorení.

Príklad: načítanie počtu nahromadených akcií

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
}

Každý inzerentský účet má k dispozícii sadu integrovaných nástrojov umelej inteligencie – generátor obsahu a vizuálov reklám, konverzačného asistenta, poradcu pre rozpočet a externého audítora SEO –, ktoré sa okrem paušálnej ročnej ceny hradia kreditmi na umelú inteligenciu.

Príklad — vytvorenie obsahu reklamy

Tá istá kategória a popis činnosti slúžia aj ako podklad pre generátor obrázkov nižšie.

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
}

Vytvorte zodpovedajúci vizuál pre tú istú reklamu:

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
}

Vložte hotový reklamný blok na svoju stránku – bez nutnosti vytvárania, bez iframe. Skript sa vykresľuje priamo na stránke v izolovanom prostredí Shadow DOM, takže jeho štýly sa nikdy neprenášajú na vašu stránku a štýly vašej stránky sa nikdy neprenášajú do neho.

Pridaj to na svoju stránku

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

V predvolenom nastavení sa tu zobrazuje kompletné verejné poradie v danej kategórii – všetci inzerenti na platforme, nielen tí, ktorých ste priviedli vy. Ak chcete zobraziť len reklamy od inzerentov, ktorých ste vytvorili prostredníctvom režimu Connect (tých, ktorí generujú váš podiel), pridajte atribút „data-partner“ s vaším partnerským ID (nájdete ho na stránke „Developers“ vo vašom vlastnom riadiacom paneli):

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

Ak vaši inzerenti pôsobia vo viacerých kategóriách, úplne vynechajte atribút „data-category“ — ak použijete len atribút „data-partner“, widget zobrazí všetky vaše reklamy zo všetkých kategórií v jednej mriežke, namiesto toho, aby bol potrebný jeden blok widgetu pre každú kategóriu:

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

Chcete popri widgete v obsahu mať aj ďalší v pätičke, pričom každý z nich bude zobrazovať iné reklamy? Pridajte druhý blok widgetu s atribútom data-layout="compact" (jedna reklama, ktorú možno zložiť do malého modulu) a atribútom data-offset nastaveným na počet reklám, ktoré už zobrazuje váš prvý 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>

Vlastnosti

Ako sa provízia za odporúčanie partnerovi skutočne vypláca – jej výška, spôsob vyplácania a podmienky.

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
}

Podmienky výplaty

• Celková suma výnosov inzerenta, ktoré sú splatné, dosiahla minimálnu výplatnú sumu.
• Na ich účte je nastavená peňaženka na výplatu kryptomien.
• Ich status KYC je overený.

Príklad: prečítanie nahromadených ziskov

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
}

Cenové úrovne (v prevádzke)

Čítajte údaje priamo z tohto koncového bodu – tieto hodnoty nikdy neuvádzajte pevne v kóde, pretože sa môžu z našej strany zmeniť. Vytvorte pre svojich používateľov výber cenových úrovní namiesto poľa s voľnou sumou: každá zobrazená cena už predstavuje presnú sumu, ktorú treba poslať pri vytváraní platby, a odomknuté výhody tu uvedené používateľom presne vysvetľujú, čo za túto cenu získajú, takže si vyberú cenu, ktorej rozumejú, namiesto toho, aby hádali nejaké číslo.

Počet požiadaviek je obmedzený na jeden kľúč za minútu. Každá overená odpoveď obsahuje hlavičky X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset; pri prekročení limitu sa vráti stav 429 Too Many Requests s hlavičkou Retry-After.

Voliteľné, pre každého partnera. Pokiaľ nepridáte žiadny záznam, vaše kľúče prijímajú požiadavky z akejkoľvek IP adresy – prvý záznam prepne všetky kľúče daného partnera do režimu „len zoznam povolených“.

Každý webhook je podpísaný pomocou algoritmu HMAC-SHA256 s využitím tajného kľúča, ktorý sa generuje jednorazovo pri jeho vytvorení – predtým, ako dôverujete obsahu správy, overte jej podpis. Udalosti sa doručujú iba partnerovi, ktorý je vlastníkom príslušného inzerenta.