Fejlesztői dokumentáció

Minden kérés hitelesítése az Authorization fejlécben szereplő titkos kulccsal történik, a Bearer séma alkalmazásával.

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

Ha az API-kulcsaid a saját felhasználóid számára hirdetői fiókokat hoznak létre (Connect mód – lásd a fenti „Hitelesítés” részt), akkor részesedést kapsz abból az összegből, amelyet ezek a hirdetők a hirdetéseikért fizetnek. Az alábbi megosztási arányt valós időben olvassa be ez a végpont, soha nem van rögzítve kódban, és teljesen független az oldal alján szereplő ajánlói jutaléktól.

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

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

Hogyan működik?

1. Az egyik „Connect” módban hirdető hirdetője az Ön integrációján keresztül fizet egy hirdetésért.
2. A hirdetést ellenőrzik és jóváhagyják – akár automatikusan, akár a moderációs csapatunk által.
3. A részesedésed sorba került az automatikus kifizetésre a pénztárcádba; ez ugyanazon a mechanizmuson alapul, mint az alábbi ajánlóprogram.

Kifizetési feltételek

• A partnerfiókodon be van állítva egy kriptovaluta-kifizetési pénztárca.
• Az Ön részéről nincs szükség KYC-ellenőrzésre – a partnerfiókját már a létrehozáskor ellenőrizték.

Példa: a felhalmozott részvények lekérése

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
}

Minden hirdetői fiókhoz egy sor beépített mesterséges intelligencia (AI) eszköz tartozik – hirdetéstartalom- és vizuális elem-generátor, beszélgetőasszisztens, költségvetési tanácsadó és külső SEO-ellenőr –, amelyek használatát az éves átalánydíj mellett AI-kreditekkel lehet finanszírozni.

Példa — hirdetési tartalom létrehozása

Ugyanez a kategória és üzleti leírás alapján működik az alábbi képgenerátor is.

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
}

Készítsen hozzá illő vizuális elemet ugyanahhoz a hirdetéshez:

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
}

Helyezz el egy kész hirdetési egységet a saját webhelyeden – nincs szükség fejlesztésre, nincs szükség iframe-re sem. A szkript közvetlenül az oldalon belül, egy elkülönített Shadow DOM-ban jelenik meg, így a stílusai soha nem kerülnek át a webhelyedre, és a webhelyed stílusai sem kerülnek át az ő oldalára.

Add hozzá az oldaladhoz

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

Alapértelmezés szerint ez a kategória teljes nyilvános rangsorát jeleníti meg – a platformon szereplő összes hirdetőt, nem csak azokat, akiket te hoztál be. Ha csak azoknak a hirdetőknek a hirdetéseit szeretnéd megjeleníteni, akiket a Connect mód segítségével hoztál létre (vagyis azokat, akik a részesedésedet generálják), add hozzá a „data-partner” attribútumot a partner-azonosítóddal (ezt a saját irányítópultod „Fejlesztők” oldalán találod meg):

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

Ha a hirdetőid több kategóriába is tartoznak, hagyd ki teljesen a „data-category” attribútumot – ha csak a „data-partner” attribútumot használod, a widget az összes kategóriában megjelenő hirdetéseidet egyetlen rácsban jeleníti meg, így nem kell kategóriánként külön widget-blokkot létrehoznod:

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

Szeretnél a tartalomban megjelenő hirdetés mellett egy lábléc-stílusú egységet is, amelyekben különböző hirdetések jelennek meg? Adj hozzá egy második widget-blokkot a data-layout="compact" attribútummal (egy hirdetés, amely kicsi „pill” méretűre összecsukható), és állítsd be a data-offset értéket arra a hirdetések számára, amennyit az első widget már megjeleníti:

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

Tulajdonságok

Hogyan jut el a partnerhez az ajánlási jutalék – a százalékos arány, a kifizetési mód és a feltételek.

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
}

Kifizetési feltételek

• A hirdető teljes kifizetendő bevétele eléri a minimális kifizetési összeget.
• A felhasználó fiókjához be van állítva egy kriptovaluta-kifizetési pénztárca.
• KYC-státuszuk hitelesítve van.

Példa: a felhalmozott nyereség leolvasása

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
}

Árkategóriák (élő)

Ezt az értéket az adott végpontról olvassa be élőben — soha ne írja be ezeket az értékeket kódba, mivel azok a mi oldalunkon változhatnak. Ahelyett, hogy egy „ingyenes mennyiség” mezőt használnál, készíts egy árkategória-választót a saját felhasználóid számára: minden feltüntetett ár már pontosan azt az összeget jelenti, amelyet a fizetés létrehozásakor el kell küldeni, és az itt megjelenő, elérhetővé vált előnyök pontosan megmutatják a felhasználóknak, hogy mit kapnak az adott árért, így olyan árat választhatnak, amelyet megértenek, ahelyett, hogy találgatniuk kellene egy számot.

A kérések száma kulcsanként és percenként korlátozott. Minden hitelesített válasz tartalmazza az X-RateLimit-Limit, X-RateLimit-Remaining és X-RateLimit-Reset fejléceket; a korlát túllépése esetén a rendszer 429 Too Many Requests hibakódot ad vissza, Retry-After fejléccel.

Opcionális, partnerenként. Amíg nem adsz hozzá bejegyzést, a kulcsaid bármely IP-címről érkező kéréseket elfogadnak — az első bejegyzés az adott partner összes kulcsát kizárólag engedélyezett listára állítja át.

Minden webhookot HMAC-SHA256-tal írnak alá egy olyan titkos kulcs segítségével, amelyet egyszer, a létrehozáskor állítanak ki — ellenőrizze az aláírást, mielőtt megbízik a hasznos adatban. Az események kizárólag annak a partnernek kerülnek továbbításra, amelyik a kapcsolódó hirdető tulajdonosa.