Dokiman pou devlopè

Chak demann otantifye ak yon kle sekrè nan antèt Otorisasyon an, lè l sèvi avèk skèm Bearer la.

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

Si kle API ou yo kreye kont piblisitè pou pwòp itilizatè ou yo (mòd Konekte — gade Otantifikasyon pi wo a), ou touche yon pati nan sa piblisitè sa yo peye pou piblisite yo. Repatisyon ki anba a li an dirèk nan menm pwen final sa a, li pa janm kode an di, epi li totalman separe de komisyon referans ki pi ba sou paj sa a.

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

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

Kijan sa mache

1. Youn nan piblisitè w yo nan mòd Connect peye pou yon piblisite atravè entegrasyon w lan.
2. Anons la revize epi apwouve — otomatikman, oswa pa ekip moderasyon nou an.
3. Pati ou a mete nan liy pou peman otomatik nan bous ou, menm mekanis ak pwogram referans ki anba a.

Kondisyon pou peman

• Yon bous peman kripto konfigire sou kont patnè ou a.
• Ou pa bezwen fè KYC sou bò ou — kont patnè ou a deja verifye depi li te kreye.

Egzanp: li aksyon akimile yo

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
}

Chak kont piblisitè jwenn yon seri zouti AI entegre — yon jeneratè kontni piblisite ak vizyèl, yon asistan konvèsasyonèl, yon konseye bidjè, ak yon oditè SEO ekstèn — peye ak kredi AI, anplis pri anyèl fiks la.

Egzanp — jenere kontni piblisite

Menm kategori a ak deskripsyon biznis la alimante tou jeneratè imaj ki anba a.

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
}

Jenere yon imaj ki koresponn pou menm piblisite a:

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
}

Depoze yon inite piblisite ki deja pare sou sit ou — pa gen etap konstriksyon, pa gen iframe. Skrip la rande dirèkteman nan paj la andedan yon Shadow DOM izole, konsa stil li yo pa janm koule nan sit ou, e stil sit ou yo pa janm koule ladan l.

Ajoute l sou paj ou a

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

Pa defo, sa a montre tout klasman piblik pou kategori a — tout piblisitè sou platfòm nan, pa sèlman sa ou te pote yo. Pou montre sèlman piblisite ki soti nan piblisitè ou kreye atravè mòd Connect (sa yo k ap jenere pati ou), ajoute data-partner ak ID patnè ou (jwenn li sou paj Devlopè nan tablodbò ou):

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

Si piblisitè ou yo kouvri plizyè kategori, retire data-category nèt — ak sèlman data-partner, widget la montre tout piblisite ou yo nan tout kategori yo nan yon sèl kadriyaj, olye pou w bezwen yon blòk widget pou chak kategori:

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

Ou vle yon inite stil footer bò kote inite nan kontni ou a, chak ap montre piblisite diferan? Ajoute yon dezyèm blòk widget ak data-layout="compact" (yon sèl piblisite, ki ka pliye an yon ti pil) epi mete data-offset selon konbyen piblisite premye widget ou a deja montre:

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

Atribit

Kijan komisyon referans yon patnè aktyèlman rive jwenn li — pousantaj la, mekanis peman an, ak kondisyon davans yo.

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
}

Kondisyon peman

• Revni total piblisitè a dwe peye a rive nan kantite minimòm pou peye a.
• Yon bous pou peman kripto konfigire sou kont yo.
• Estati KYC yo verifye.

Egzanp: li revni akimile

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
}

Nivo pri (an dirèk)

Li an tan reyèl nan endpoint sa a — pa janm ekri valè sa yo dirèkteman nan kòd, yo ka chanje bò kote nou. Bati yon chwazè nivo pou pwòp itilizatè ou yo olye de yon chan kantite gratis: chak pri ki parèt se deja egzakteman kantite pou voye lè w ap kreye peman an, epi benefis ki debloke yo montre itilizatè yo egzakteman sa pri sa a ba yo, konsa yo chwazi yon pri yo konprann olye de devine yon nimewo.

Demann yo limite pa kle, pa minit. Chak repons otantifye pote antèt X-RateLimit-Limit, X-RateLimit-Remaining, ak X-RateLimit-Reset; depase limit la retounen kòd 429 Twòp Demann ak antèt Retry-After.

Opsyonèl, pa patnè. Jiskaske ou ajoute yon antre, kle ou yo aksepte demann ki soti nan nenpòt IP — premye antre a chanje tout kle patnè sa a pou yo sèlman sou lis pèmèt.

Chak webhook siyen ak HMAC-SHA256 lè l sèvi avèk yon sekrè ki bay yon sèl fwa nan moman kreyasyon — verifye siyati a anvan ou fè konfyans chaj la. Evènman yo delivre sèlman bay patnè ki posede piblisitè ki gen rapò a.