Litokomane tsa moqapi

Kopo e 'ngoe le e 'ngoe e netefatsoa ka senotlolo se lekunutu se ho Authorization header, ho sebelisoa mokhoa oa Bearer.

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

Haeba di-key tsa hau tsa API di theha diakhaonto tsa babapatsi bakeng sa basebelisi ba hau (mokgwa wa Connect — bona Netefatso hodimo), o fumana karolo ya seo babapatsi bao ba se lefang bakeng sa dipapatso tsa bona. Kgaohano e ka tlase e balwa ka kotloloho ho tswa ho endpoint ena e tshwanang, ha e eso ke e ngolwe ka ho sa feleng khoutung, mme e arohane ka ho feletseng le khomishene ya phetisetso e tlase leqepheng lena.

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

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

E sebetsa joang

1. E mong oa babapatsi ba hau ba mokhoa oa Connect o lefa bakeng sa papatso ka khokahano ea hau.
2. Papatso e hlahlojoa le ho amoheloa — ka bo eona, kapa ke sehlopha sa rona sa taolo.
3. Karolo ea hau e behiloe moleng bakeng sa tefo e itšebetsang ka mokotleng oa hau, ka mokhoa o tšoanang le oa lenaneo la ho buella le ka tlase.

Maemo a tefo

• Sepache sa tefo ea crypto se hlophisitsoe akhaontong ea molekane oa hau.
• Ha ho hlokahale hore u etse KYC — ak'haonte ea molekane oa hau e se e hlahlobiloe ha e ne e theoa.

Mohlala: ho bala diabo tse bokelletsoeng

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
}

Ak'haonte e 'ngoe le e 'ngoe ea papatso e fumana sete ea lisebelisoa tse hahelletsoeng tsa AI — mohlahisi oa litaba tsa papatso le litšoantšo, mothusi oa moqoqo, moeletsi oa tekanyetso, le mohlahlobi oa SEO oa kantle — tse lefuoang ka likhrediti tsa AI, holim'a theko e sa fetoheng ea selemo le selemo.

Mohlala — hlahisa dikahare tsa papatso

Sehlopha se tšoanang le tlhaloso ea khoebo li boetse li tsamaisa mochine o hlahisang setšoantšo se ka tlase.

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
}

Hlahisa setšoantšo se tsamaellanang le papatso e tšoanang:

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
}

Beha yuniti ya papatso e seng e lokile sebakeng sa hao sa marang-rang — ha ho hlokahale mohato wa ho e haha, ha ho hlokahale iframe. Sekeripiti se hlahisa ka kotloloho leqepheng ka hare ho Shadow DOM e ikemetseng, kahoo mekgwa ya setaele sa yona ha e kene sebakeng sa hao sa marang-rang, mme mekgwa ya setaele sa sebaka sa hao sa marang-rang ha e kene ho yona.

E kenye leqepheng la hao

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

Ka tloaelo sena se bontsha maemo a feletseng a setjhaba a sehlopha — mohwebisi e mong le e mong sethaleng, eseng feela ba o ba kentseng. Ho bontsha feela dipapatso tse tswang ho bahwebisi bao o ba entseng ka mokgwa wa Connect (ba hlahisang kabelo ya hao), eketsa data-partner ka ID ya molekane wa hao (e fumane leqepheng la Bahlahisi la dashboard ya hao):

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

Haeba lipapatso tsa hau li akaretsa mekhahlelo e 'maloa, tlohela data-category ka ho feletseng — ka data-partner feela, widget e bontša papatso e 'ngoe le e 'ngoe ea hau mekhahlelong eohle ka har'a grida e le 'ngoe, ho fapana le ho hloka blokho ea widget e le 'ngoe bakeng sa mokhahlelo o mong le o mong:

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

O batla yuniti ya mofuta wa footer pela ya hao e ka hara dikahare, e nngwe le e nngwe e bontsha dipapatso tse fapaneng? Kenya blokhose ya bobedi ya widget ka data-layout="compact" (papatso e le nngwe, e ka phutholohang ho ba sebopeho se senyenyane sa pilisi) le data-offset e behilweng ho ya ka hore na widget ya hao ya pele e se e bontsha dipapatso tse kae:

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

Litšobotsi

Kamoo khomishene ea phetisetso ea molekane e fihlang ho eena — peresente, mokhoa oa tefo, le lipehelo tsa pele.

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
}

Maemo a tefo

• Kakaretso ea meputso e lefuoang ea moholisi e fihla tekanyong e tlase ea tefo.
• Sepache sa tefo ea crypto se hlophisitsoe akhaontong ea bona.
• Boemo ba bona ba KYC bo netefalitsoe.

Mohlala: ho bala meputso e bokeletsweng

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
}

Maemo a ditheko (e sebetsang)

Bala ka kotloloho ho tsoa ho endpoint ena — le ka mohla u se ke oa ngola litekanyetso tsena ka khoutu, li ka fetoha ka lehlakoreng la rona. Etsa khetho ea maemo bakeng sa basebelisi ba hau ho fapana le lebokose la chelete ea mahala: theko e 'ngoe le e 'ngoe e bontšitsoeng ke chelete e nepahetseng eo u lokelang ho e romela ha u etsa tefo, 'me melemo e buletsoeng e bontšitsoeng mona e bolella basebelisi hantle hore na theko eo e ba fa eng, e le hore ba khethe theko eo ba e utloisisang ho fapana le ho hakanya nomoro.

Likopo li lekanyelitsoe ka senotlolo ka motsotso. Karabo e 'ngoe le e 'ngoe e netefalitsoeng e na le lihlooho tsa X-RateLimit-Limit, X-RateLimit-Remaining, le X-RateLimit-Reset; ho feta moeli ho khutlisa 429 Too Many Requests ka sehlooho sa Retry-After.

Khetho, ka molekane ka mong. Ho fihlela o kenya keno, linotlolo tsa hao li amohela likopo tse tsoang ho IP efe kapa efe — keno ea pele e fetola linotlolo tsohle tsa molekane eo hore li lumelle feela tse thathamisitsoeng.

Webhook e 'ngoe le e 'ngoe e saennoe ka HMAC-SHA256 ho sebelisoa sephiri se fanoeng hang feela, nakong ea tlhahiso — netefatsa mosaeno pele o tšepa mojaro. Liketsahalo li isoa feela ho molekane ea nang le moitsebiso ea amanang.