Imibhalo yomthuthukisi

Zonke izicelo ziqinisekiswa ngokhiye oyimfihlo kwi-Authorization header, kusetshenziswa uhlelo lwe-Bearer.

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

Uma izihluthulelo zakho ze-API zisungula ama-akhawunti abakhangisi kubasebenzisi bakho (imodi yokuxhuma — bheka Ukuqinisekiswa ngenhla), uthola ingxenye yalokho abakhangisi abakukhokha kwezikhangiso zabo. Ukuhlukaniswa okungezansi kufundwa bukhoma kule ndawo efanayo yokuphela, akukaze kubhalwe ngqo, futhi kuhlukile ngokuphelele ekhomishini yokudlulisela ekhoneni elingezansi kwale khasi.

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

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

Isebenza kanjani

1. Omunye wabakhankaseli bakho be-Connect-mode ukhokhela isikhangiso ngokusebenzisa ukuhlanganiswa kwakho.
2. Isikhangiso sihlolwa futhi sivunywa — ngokuzenzakalelayo, noma yiqembu lethu lokulawula.
3. Ingxenye yakho isethwe kuluhlu lokukhokhelwa ngokuzenzakalelayo kwipheshana lakho, ngendlela efanayo nohlelo lokudlulisela olungezansi.

Imiqathango yokukhokha

• Isikhwama sokukhokha se-crypto silungiselelwe ku-akhawunti yomlingani wakho.
• Akudingeki i-KYC ngakolunye uhlangothi lwakho — i-akhawunti yomlingani wakho isivele ihlolwe ngesikhathi idalwa.

Isibonelo: ukufunda izabelo eziqoqile

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
}

I-akhawunti ngayinye yomkhangisi ithola isethi yamathuluzi e-AI akhelwe ngaphakathi — umkhiqizi wokukhangisa nokukhiqiza izithombe, umsizi wokuxoxa, umeluleki wezabelomali, nomhloli we-SEO wangaphandle — okukhokhelwa ngamakhridithi e-AI, ngaphezu kwentengo yonyaka engaguquki.

Isibonelo — khiqiza okuqukethwe kwesikhangiso

Isigaba esifanayo kanye nencazelo yebhizinisi nazo zinika amandla umkhiqizi wesithombe ongezansi.

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
}

Khiqiza isithombe esihambisanayo sesikhangiso esifanayo:

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
}

Thela iyunithi yokukhangisa esivele yakhiwe kusayithi lakho — akudingeki izinyathelo zokwakha, akudingeki i-iframe. Iskripthi libonisa ngqo ekhasini ngaphakathi ku-Shadow DOM ehlukanisiwe, ngakho izitayela zaso azikaze zidlulele kusayithi lakho, futhi izitayela zokusayithi lakho azikaze zidlulele kuso.

Yengeza ekhasini lakho

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

Ngokujwayelekile lokhu kukhombisa wonke umphakathi wokuhlelwa kwezigaba — wonke umkhangisi epulatifomu, hhayi nje labo obasungule. Ukuze ukhombise kuphela izikhangiso ezivela kubakhangisi obasungule ngendlela ye-Connect mode (labo abakhiqiza ingxenye yakho), engeza data-partner kanye ne-ID yomlingani wakho (thola ku-Developers page kwideshibhodi yakho):

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

Uma abakhangisi bakho behlanganisa izigaba eziningi, susa ngokuphelele i-data-category — usebenzisa i-data-partner kuphela, i-widget iveza zonke izikhangiso zakho kuzo zonke izigaba ku-grid eyodwa, kunokuba udinge ibhulokhi ye-widget eyodwa kwisigaba ngasinye:

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

Ufuna iyunithi yesitayela se-footer eceleni kweyunithi yakho engaphakathi kokuqukethwe, ngayinye ikhombisa izikhangiso ezahlukene? Yongeza ibhulokhi yesibili ye-widget ene-data-layout="compact" (isikhangiso esisodwa, esingancishiswa sibe iphili encane) kanye ne-data-offset usethe inani lezikhangiso i-widget yakho yokuqala esivele ikhombisa:

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

Izici

Indlela ikhomishini yokudlulisela yomlingani efika ngayo kubo empeleni — iphesenti, indlela yokukhokha, nezimfuneko zangaphambi.

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
}

Imiqathango yokukhokha

• Inani eliphelele lemali okufanele ikhokhwe kumkhangisi lifinyelela kwinani elincane lokukhokha.
• Isikhwama sokukhokha se-crypto silungiselelwe ku-akhawunti yabo.
• Isimo sabo se-KYC siqinisekisiwe.

Isibonelo: ukufunda imali eqoqiwe

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
}

Izinga lamazinga entengo (bukhoma)

Funda bukhoma kusuka kule endpoint — ungaze ubhale la manani ngqo kukhodi, angashintsha ohlangothini lwethu. Yakha isikhethi sezingeni sabasebenzisi bakho esikhundleni sendawo yokufaka inani lamahhala: intengo ngayinye ebonisiwe isivele iyinani eliqondile okufanele lithunyelwe lapho kwakhiwa inkokhelo, kanti izinzuzo ezivuliwe eziboniswe lapha zitshela abasebenzisi ngokunembile ukuthi leyo ntengo ibanikeza ini, ukuze bakhethe intengo abayiqondayo esikhundleni sokuzama inombolo.

Izicelo zilinganiselwa ngokhiye ngomzuzu. Yonke impendulo eqinisekisiwe iqukethe izihloko ze-X-RateLimit-Limit, X-RateLimit-Remaining, kanye ne-X-RateLimit-Reset; ukweqa umkhawulo kubuyisa i-429 Too Many Requests enesihloko se-Retry-After.

Okuzikhethela kumlingani ngamunye. Kuze kube usengeza okungena, izihluthulelo zakho zamukela izicelo ezivela kunoma iyiphi ikheli le-IP — ukufakwa kokuqala kushintsha zonke izihluthulelo zalowo mlingani zibe ohlwini oluvunyelwe kuphela.

I-webhook ngayinye isayinwa nge-HMAC-SHA256 kusetshenziswa imfihlo ekhishwe kanye ngesikhathi sokudala — qinisekisa isiginesha ngaphambi kokwethemba umthwalo wedatha. Izehlakalo zithunyelwa kuphela kumlingani ongumnikazi womkhangisi ohambisanayo.