Dokumentace pro vývojáře

Každý požadavek je ověřován pomocí tajného klíče v hlavičce „Authorization“ s využitím schématu „Bearer“.

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

Pokud vaše API klíče vytvářejí inzerentské účty pro vaše vlastní uživatele (režim Connect – viz část „Ověřování“ výše), získáváte podíl z částek, které tito inzerenti platí za své reklamy. Níže uvedené rozdělení se načítá v reálném čase z tohoto stejného koncového bodu, nikdy není pevně zakódováno a je zcela oddělené od provize za doporučení, o které se píše dále na této stránce.

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

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

Jak to funguje

1. Jeden z vašich inzerentů v režimu Connect zaplatí za reklamu prostřednictvím vaší integrace.
2. Reklama je zkontrolována a schválena – buď automaticky, nebo naším moderátorským týmem.
3. Váš podíl je zařazen do fronty pro automatickou výplatu do vaší peněženky, a to stejným způsobem jako v rámci níže uvedeného programu doporučení.

Podmínky výplaty

• Na vašem partnerském účtu je nastavena peněženka pro výplaty v kryptoměnách.
• Z vaší strany není vyžadováno žádné ověření totožnosti (KYC) – váš partnerský účet byl prověřen již při jeho založení.

Příklad: načtení počtu nahromaděný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 dispozici sadu integrovaných nástrojů založených na umělé inteligenci – generátor obsahu a vizuálních prvků reklam, konverzačního asistenta, poradce pro rozpočet a externího auditora SEO –, které se hradí pomocí kreditů na umělou inteligenci, a to nad rámec paušálního ročního poplatku.

Příklad – generování obsahu reklamy

Stejná kategorie a popis činnosti slouží také jako podklad pro níže uvedený generátor obrázků.

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
}

Vytvořte odpovídající vizuál pro stejnou 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 svůj web – bez nutnosti vytváření, bez iframe. Skript se vykresluje přímo na stránce v izolovaném Shadow DOM, takže jeho styly nikdy neovlivní váš web a styly vašeho webu nikdy neovlivní ten jeho.

Přidejte si to na svou 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>

Ve výchozím nastavení se zde zobrazuje kompletní veřejné žebříčky pro danou kategorii – tedy všichni inzerenti na platformě, nejen ti, které jste přivedli. Chcete-li zobrazit pouze reklamy od inzerentů, které jste získali prostřednictvím režimu Connect (tedy těch, kteří generují váš podíl), přidejte atribut `data-partner` s vaším partnerským ID (najdete ho na stránce „Developers“ ve vašem vlastním dashboardu):

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

Pokud vaši inzerenti spadají do několika kategorií, vynechte atribut `data-category` úplně – pokud použijete pouze atribut `data-partner`, widget zobrazí všechny vaše reklamy ze všech kategorií v jedné mřížce, místo aby byl pro každou kategorii potřeba jeden blok widgetu:

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

Chcete vedle widgetu v obsahu mít ještě jeden ve stylu zápatí, přičemž každý z nich bude zobrazovat jiné reklamy? Přidejte druhý blok widgetu s atributem data-layout="compact" (jedna reklama, kterou lze sbalit do malého rámečku) a atributem data-offset nastaveným na počet reklam, které již zobrazuje váš první 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>

Atributy

Jak se provize za doporučení partnerovi skutečně dostane – procentní sazba, způsob výplaty a podmínky.

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
}

Podmínky výplaty

• Celková částka výdělků inzerenta, která má být vyplacena, dosáhla minimální částky pro výplatu.
• Na jejich účtu je nastavena peněženka pro výplaty v kryptoměnách.
• Jejich status KYC je ověřen.

Příklad: výpis nahromaděných výdělků

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é úrovně (v provozu)

Čtěte hodnoty přímo z tohoto koncového bodu – tyto hodnoty nikdy nezadávejte pevně, protože se mohou z naší strany změnit. Vytvořte pro své uživatele výběr cenových úrovní namísto pole pro volbu částky: každá zobrazená cena již představuje přesnou částku, kterou je třeba odeslat při vytváření platby, a zde zobrazené odemčené výhody uživatelům přesně sdělují, co za danou cenu získají, takže si vyberou cenu, které rozumějí, místo aby hádali částku.

Počet požadavků je omezen na klíč za minutu. Každá ověřená odpověď obsahuje hlavičky X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset; při překročení limitu je vrácen kód 429 Too Many Requests s hlavičkou Retry-After.

Volitelné, pro každého partnera. Dokud nepřidáte žádný záznam, vaše klíče přijímají požadavky z jakékoli IP adresy – první záznam přepne všechny klíče daného partnera do režimu „pouze povolené adresy“.

Každý webhook je podepsán pomocí algoritmu HMAC-SHA256 s využitím tajného klíče, který se generuje jednorázově při jeho vytvoření – předtím, než důvěřujete obsahu, ověřte podpis. Události jsou doručovány pouze partnerovi, který je vlastníkem příslušného inzerenta.