Matsalwa ya Muhluvukisi

Xikombelo xin'wana na xin'wana xi tiyisisiwa hi xilotlelo xa xihundla eka nhloko ya Mpfumelelo, hi ku tirhisa maendlelo ya Bearer.

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

Loko ti-API keys ta wena ti tumbuluxa ti-akhawunti ta vaxavisi eka vatirhisi va wena (Connect mode — vona Authentication laha henhla), u kuma xiphemu xa leswi vaxavisi volavo va swi hakelaka eka swinavetiso swa vona. Ku avanyisiwa loku nga laha hansi ku hlayawa hi ku kongoma ku suka eka endpoint leyi fanaka, a ku si tshama ku tsariwa hi ku kongoma eka khodi, naswona ku hambanisiwile hi ku helela eka khomixini ya vurhumiwa leyi nga ehansi eka tluka leri.

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

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

Ndlela leyi swi tirhaka ha yona

1. Un'wana wa vaxavisi va wena va Connect-mode u hakela xikhangiso hi ku tirhisa vuhlanganisi bya wena.
2. Xikhangelo xi kambisisiwa no pfumeleriwa — hi xoxe, kumbe hi ntlawa wa hina wo lawula.
3. Xiphemu xa wena xi vekisiwile leswaku xi hakeleriwa hi xoxe eka xipachi xa wena, hi maendlelo lama fanaka na nongonoko wa vurhumeri lowu nga laha hansi.

Swipimelo swa hakelo

• Wallet yo hakela ya crypto yi lulamisiwile eka akhawunti ya munhu loyi u tirhisanaka na yena.
• A ku laveki KYC eka tlhelo ra wena — akhawunti ya munhu loyi u tirhisanaka na yena se yi kambisisiwile loko yi sunguriwa.

Xikombiso: ku hlaya swiavelo leswi hlengeletaneke

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
}

Akawunti yin'wana na yin'wana ya mukhangisi yi kuma ntlawa wa switirhisiwa swa AI leswi akiweke endzeni — xitumbuluxi xa vuxokoxoko bya swikhangiso na swifaniso, mupfuni wa mabulo, mutsundzuxi wa mpimanyeto wa timali, na muhlahluvi wa le handle wa SEO — leswi hakeriwaka hi tikhirediti ta AI, ku engetela eka ntsengo lowu nga cinciwiki wa lembe na lembe.

Xikombiso — tumbuluxa vuxokoxoko bya xikhangiso

Ntlawa lowu fanaka na nhlamuselo ya bindzu na swona swi tirhisa jeneretara ya swifaniso leyi nga laha hansi.

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
}

Endla xifaniso lexi fambisanaka na xikhangiso lexi fanaka:

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
}

Veka xiyenge xa xikhangiso lexi se xi lulamiseriweke eka sayiti ya wena — a ku laveki ku aka, a ku laveki iframe. Xikripti xi humelerisa xivono hi ku kongoma eka tluka endzeni ka Shadow DOM leyi hambanisiweke, hikokwalaho switayili swa yona a swi ngheneli eka sayiti ya wena, naswona switayili swa sayiti ya wena a swi ngheneli eka yona.

Engetela eka tluka ra wena

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

Hi ntolovelo leswi swi kombisa xiyimo xa le rivaleni lexi heleleke xa ntlawa — muxavisi un'wana na un'wana eka pulatifomo, ku nga ri ntsena lava u va ngheniseke. Ku kombisa ntsena swinavetiso swa vaxavisi lava u va tumbuluxeke hi ku tirhisa Connect mode (lava va endlaka xiphemu xa wena), engetela data-partner na partner ID ya wena (yi kumeni eka tluka ra Vathuthukisi eka dashboard ya wena):

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

Loko swinavetisi swa wena swi katsa swiyenge swo tala, tshika data-category hi ku helela — hi ku tirhisa data-partner ntsena, widget yi kombisa swinavetisi swa wena hinkwaswo eka swiyenge hinkwaswo eka giridi yin'we, ematshan'weni yo lava block ya widget yin'we eka xiyenge xin'wana na xin'wana:

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

Xana u lava yuniti ya xitayili xa footer etlhelo ka leyi ya wena ya le ndzeni ka vuxokoxoko, yin'wana na yin'wana yi kombisa swinavetiso swo hambana? Engetela bloko ya vumbirhi ya widget hi ku tirhisa data-layout="compact" (xinavetiso xin'we, lexi nga pfinyiwaka xi va xirhendzevutana lexitsongo) na data-offset leyi vekiweke hi ku ya hi nhlayo ya swinavetiso leswi widget ya wena yo sungula se yi swi kombisaka:

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

Swihlawulekisi

Ndlela leyi khomixini ya referalo ya mutirhisani yi n'wi fikelelaka ha yona — phesente, maendlelo yo hakela, na swilaveko swo rhanga.

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
}

Swipimelo swa hakelo

• Ntsengo hinkwawo wa mali leyi muvhangisi a faneleke ku yi hakela wu fika eka ntsengo wa le hansi lowu hakeriwaka.
• Wallet yo hakela ya crypto yi lulamisiwile eka akhawunti ya vona.
• Xiyimo xa vona xa KYC xi tiyisisiwile.

Xikombiso: ku hlaya mbuyelo lowu hlengeletaneke

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
}

Swiyimo swa mitlhoto (swa nkarhi wa xiviri)

Hlaya hi ku kongoma kusuka eka endpoint leyi — u nga tshuki u tsala tinhlayo leti hi ku kongoma eka khodi, ti nga cinca eka tlhelo ra hina. Endla xihlawuri xa swiyimo xa vatirhisi va wena ematshan'weni ya ndhawu ya ntsengo wa mahala: ntsengo wun'wana na wun'wana lowu kombisiwaka i ntsengo lowu faneleke ku rhumeriwa loko ku endliwa hakelo, naswona vuyelo lebyi pfuleriweke lebyi kombisiwaka laha byi byela vatirhisi hi ku kongoma leswi ntsengo wolowo wu va nyikaka swona, leswaku va hlawula ntsengo lowu va wu twisisaka ematshan'weni yo ringanyeta nomboro.

Swikombelo swi pimiwile hi khiyi yin'we, hi minete. Nhlamulo yin'wana na yin'wana leyi tiyisisiweke yi rhwala ti-header ta X-RateLimit-Limit, X-RateLimit-Remaining, na X-RateLimit-Reset; ku tlula mpimo swi vuyisa 429 Too Many Requests na header ya Retry-After.

Hi ku tihlawulela, hi xirho xin'wana na xin'wana. Ku fikela loko u engetela xingheniso, swilotlelo swa wena swi amukela swikombelo swo huma eka IP yihi na yihi — xingheniso xo sungula xi cinca swilotlelo hinkwaswo swa xirho xexo leswaku swi pfumelela ntsena leswi nga eka nxaxamelo wa mpfumelelo.

Webhook yin'wana na yin'wana yi sayiniwa hi HMAC-SHA256 hi ku tirhisa xihundla lexi humesiweke kan'we ntsena, hi nkarhi wa ku tumbuluxiwa — tiyisisa sayini u nga si tshemba leswi rhumeriweke. Swiendlakalo swi yisiwa ntsena eka mutirhisani loyi a nga n'wini wa mukhangisi la fambisanaka na swona.