Amaxwebhu omphuhlisi

Yonke isicelo siqinisekiswa ngesitshixo esiyimfihlo kwi-Authorization header, kusetyenziswa i-Bearer scheme.

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

Ukuba i-API keys zakho zenza ii-akhawunti zabathengisi kubasebenzisi bakho (i-Connect mode — bona i-Authentication apha ngasentla), ufumana isabelo sento abayihlawulayo abo bathengisi ngeentengiso zabo. Ukwabiwa okungezantsi kufundwa ngqo kule endpoint inye, akukhe kwafakwa ngokungaguqukiyo kwikhowudi, kwaye kwahluke ngokupheleleyo kwikhomishini yokuthumela ekuzantsi kweli phepha.

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

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

Indlela esebenza ngayo

1. Omnye wabathengisi bakho be-Connect-mode uhlawulela isibhengezo ngokusebenzisa ukudityaniswa kwakho.
2. Isibhengezo sihlolwa size samkelwe — ngokuzenzekelayo, okanye liqela lethu lolawulo.
3. Isabelo sakho si kuluhlu lokuhlawulwa ngokuzenzekelayo kwisipaji sakho, ngendlela efanayo neyeprogram yokuthumela abantu engezantsi.

Imiqathango yokuhlawulwa

• I-wallet yokuhlawula nge-crypto isetiwe kwi-akhawunti yomlingane wakho.
• Akukho KYC ifunekayo kwicala lakho — i-akhawunti yomlingane wakho sele ihlolwe xa yayisenzwa.

Umzekelo: ukufunda izabelo ezidibeneyo

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 nganye yomthengisi-ntengiso ifumana iseti yezixhobo ze-AI ezakhelwe ngaphakathi — umvelisi womxholo wentengiso nomfanekiso, umncedisi wencoko, umcebisi wohlahlo-lwabiwo-mali, kunye nomhloli we-SEO wangaphandle — ezihlawulelwa ngeekhredithi ze-AI, phezu kwentlawulo yonyaka engaguqukiyo.

Umzekelo — yenza umxholo wentengiso

Udidi olufanayo kunye nenkcazelo yeshishini zikwenza usebenze isenzi somfanekiso esingezantsi.

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
}

Yenza umfanekiso ohambelanayo wesi sibhengezo sinye:

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
}

Faka iyunithi yesibhengezo esele lenziwe kwisayithi yakho — akukho nyathelo lokwakha, akukho iframe. I-script ivelisa ngqo kwiphepha ngaphakathi kwi-Shadow DOM eyodwa, ngoko ke izitayile zayo azikhe zingene kwisayithi yakho, kwaye nezitayile zesayithi yakho azikhe zingene kuyo.

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

Ngokwesiqhelo oku kubonisa uluhlu olupheleleyo loluntu lwekhathego — wonke umthengisi-ntengiso oqongeni, hayi nje abo ubazisileyo. Ukuze ubonise kuphela iintengiso ezivela kubathengisi-ntengiso obadale nge-Connect mode (abo benza isabelo sakho), yongeza i-data-partner kunye ne-partner ID yakho (yifumane kwiphepha labaPhuhlisi kwideshbhodi 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>

Ukuba abathengisi bakho beentengiso babandakanya iindidi ezininzi, yilahle ngokupheleleyo i-data-category — usebenzisa i-data-partner yodwa, i-widget ibonisa zonke iintengiso zakho kuzo zonke iindidi kwigridi enye, endaweni yokuba ufune ibhloko enye ye-widget kwindidi nganye:

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

Ufuna iyunithi yohlobo lwe-footer ecaleni kweyona ikwimixholo yakho, zombini zibonisa izibhengezo ezahlukeneyo? Yongeza ibhloko yewijethi yesibini ene data-layout="compact" (isibhengezo esinye, esinokuthi sincitshiswe sibe yipilisi encinci) kunye ne data-offset emiselwe kwinani lezibhengezo esele ziboniswa ywijethi yakho yokuqala:

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

Iimpawu

Indlela ikhomishini yokuthumela umntu enyanzeleka ngayo kumthengi wobambiswano — ipesenti, indlela yokuhlawula, kunye neemeko ezifunekayo.

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 yokuhlawulwa

• Ingeniso iyonke yomthengisi-ntengiso ehlawulwayo ifikelela kwinani elincinci elihlawulwayo.
• I-wallet yokuhlawula nge-crypto isetiwe kwi-akhawunti yabo.
• Isimo sabo se-KYC siqinisekisiwe.

Umzekelo: ukufunda imivuzo eqokelelweyo

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
}

Amanqanaba amaxabiso (akwabelwa ngoku)

Funda ngqo kweli candelo — ungaze uzibhalele ngqo ezi xabiso, zinokutshintsha kwicala lethu. Yakha isikhethi seenqanaba sabasebenzisi bakho endaweni yomhlaba wemali yasimahla: ixabiso ngalinye eliboniswayo sele liyinkcitho kanye ekufuneka ithunyelwe xa kwenziwa intlawulo, kwaye iinzuzo ezivuliweyo eziboniswe apha zixelela abasebenzisi kanye ukuba lixabiso libaphi, ukuze bakhethe ixabiso abalisiqondayo endaweni yokuqikelela inani.

Iicelo zilinganiselwe ngokwekhiyi, ngomzuzu. Yonke impendulo eqinisekisiweyo iphethe ii-headers ze-X-RateLimit-Limit, i-X-RateLimit-Remaining, kunye ne-X-RateLimit-Reset; ukugqitha umda kubuyisa i-429 Too Many Requests ene-headers ye-Retry-After.

Okuzikhethelayo, ngomlingane ngamnye. De wongeze ungeniso, izitshixo zakho zamkela izicelo ezivela kuyo nayiphi na i-IP — ungeniso wokuqala utshintsha zonke izitshixo zaloo mlingane zibe zovumela uluhlu oluvumelekileyo kuphela.

I-webhook nganye isayinwe nge-HMAC-SHA256 kusetyenziswa imfihlo ekhutshwe kanye ngexesha lokudala — qinisekisa isayini phambi kokuba uthembe ipayload. Iziganeko zihanjiswa kuphela kwiqabane elingumnini welo nxulumene nomthengisi.