Mikanda ya mobɔngisi

Esɛngi nyonso endimamaka na fungola ya sekɛlɛ na kati ya motó ya Authorization, na kosaleláká lolenge ya Bearer.

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

Soki ba clés API na yo efungolaka ba comptes ya bapanzi-nsango mpo na basali na yo moko (mode ya Connect — tala Authentication na likolo), ozwi eteni ya mosolo oyo bapanzi-nsango wana bafutaka mpo na ba publicités na bango. Bokaboli oyo ezali na nse etangamaka na ntango moko longwa na endpoint oyo kaka, ekomamaka na code te, mpe ekabwani mobimba na commission ya referral oyo ezali na nse ya lokasa oyo.

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

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

Ndenge esalaka

1. Moko ya bapanzi-nsango na yo ya Connect-mode afuti pona liyebisi na nzela ya intégration na yo.
2. Lopublisite etalelami mpe endimami — na lolenge ya automatique, to na ekipi na biso ya botalisi.
3. Parti na yo etiami na molongo mpo na kofutama automatique na porte-monnaie na yo, lolenge moko na programme ya referral oyo ezali na nse.

Mibeko ya kofuta

• Portemonnaie ya kofuta na crypto ebongisami na compte ya partenaire na yo.
• Esengeli te KYC na ngambo na yo — compte ya partenaire na yo endimamaki kala ntango esalemaki.

Ndakisa: kotanga ba actions oyo ebombami

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
}

Konti nyonso ya motekisi ya pub ezalaka na ebele ya bisaleli ya AI oyo ezali na kati — ebimiseli ya makambo ya pub mpe ya bilili, mosungi ya masolo, mopesi-toli ya budget, mpe motali ya libanda ya SEO — oyo efutamaka na ba crédits ya AI, likolo ya ntalo moko ya mobu mobimba.

Ndakisa — kobimisa makambo ya publicité

Catégorie moko wana mpe ndimbola ya mosala epesaka mpe nguya na ebimiseli ya bilili oyo ezali na nse.

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
}

Salá elilingi oyo ekokani mpo na publicité yango:

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
}

Tyá unité ya publicité oyo esili kobongisama na site na yo moko — esengeli te kotonga yango, esengeli mpe te kosalela iframe. Script yango emonanaka mbala moko na kati ya lokasa, na kati ya Shadow DOM oyo ekabwani, na boye ete ba styles na yango ekɔtaka ata moke te na site na yo, mpe ba styles ya site na yo mpe ekɔtaka ata moke te na kati na yango.

Bakisa yango na lokasa na yo

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

Na ndenge ya liboso, oyo emonisaka molongo mobimba ya bapublisite mpo na etuluku — publisite nyonso na esika oyo, kasi kaka te baoyo yo omemaki. Mpo na komonisa kaka ba publisite ya bapublisite oyo osalaki na nzela ya Connect mode (baoyo bazali kobimisa eteni na yo), bakisa data-partner na ID ya partenaire na yo (zwa yango na lokasa ya ba Développeurs na dashboard na yo moko):

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

Soki ba publicités na yo ezali na ba catégories ebele, longola data-category mobimba — na kosaleláká kaka data-partner, widget emonisaka publicité na yo nyonso na ba catégories nyonso na kati ya grille moko, na esika ya kozala na bloc moko ya widget mpo na catégorie moko na moko:

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

Olingi unité ya lolenge ya footer pembeni ya oyo ya kati ya contenu na yo, mpe moko na moko ezala komonisa ba publicités ekeseni? Bakisa bloc ya widget ya mibale na data-layout="compact" (publicité moko, oyo ekoki kokunjama na kati ya eloko moke) mpe data-offset etiyama na motango ya ba publicités oyo widget na yo ya liboso ezali komonisa déjà:

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

Bizaleli

Ndenge nini commission ya referral ya partenaire ekómelaka ye mpenza — pourcentage, lolenge ya kofuta, mpe makambo esengeli kosalema liboso.

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
}

Mibeko ya kofuta

• Lofuta mobimba oyo mosakoli asengeli kofuta ekómi na motango ya nse oyo esengeli kofuta.
• Wallet ya kofuta na crypto ebongisami na compte na bango.
• Statut na bango ya KYC endimami.

Ndakisa: kotanga mbongo oyo ekɔtɔ

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
}

Biteni ya ntalo (ezali kosala)

Tángá na ntango ya solo uta na endpoint oyo — kokoma ata moke te ba valeurs oyo na code, zambi ekoki kobongwana na ngambo na biso. Salá esaleli ya kopona nivo mpo na basali na yo na esika ya esika ya kokoma motango ya ofele: ntalo nyonso oyo emonisami ezali déjà motango ya sikisiki ya kotinda ntango ozali kosala lifuti, mpe matomba oyo efungwami mpe emonisami awa elakisaka basali polele nini ntalo wana ekopesa bango, na boye bapona ntalo oyo bakoki kososola na esika ya komeka motango na makanisi.

Basɛngi ekangami na ndelo moko mpo na fungola, na miniti moko. Eyano nyonso oyo endimami ememaka ba en-tête X-RateLimit-Limit, X-RateLimit-Remaining, mpe X-RateLimit-Reset; soki oleki ndelo, ezongisaka code 429 Too Many Requests elongo na en-tête Retry-After.

Ya kopona, mpo na partenaire moko. Kino okobakisa entrée, ba clés na yo endimaka basɛngi nyonso kowuta na IP nyonso — entrée ya liboso ebongolaka ba clés nyonso ya partenaire wana mpo endima kaka ba adresi oyo ezali na liste ya ndingisa.

Webhook nyonso esignamaka na HMAC-SHA256 na kosaleláká sekre moko oyo epesamaka kaka mbala moko na ntango ya bokeli — talá soki signature ezali ya solo liboso ya kotiela payload motema. Ba événements etindamaka kaka epai ya partenaire oyo azali nkolo ya motekisi oyo etali yango.