Dokumentazzjoni għall-iżviluppaturi

Kull talba tiġi awtentikata b'ċavetta sigrieta fil-header tal-Awtorizzazzjoni, billi tuża l-iskema Bearer.

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

Jekk iċ-ċwievet tal-API tiegħek joħolqu kontijiet ta' reklamaturi għall-utenti tiegħek stess (modalità Connect — ara l-Awtentikazzjoni hawn fuq), inti tirbaħ sehem minn dak li jħallsu dawk ir-reklamaturi għall-irklami tagħhom. Il-qsim hawn taħt jinqara direttament minn dan l-istess endpoint, qatt ma jkun hardcoded, u huwa kompletament separat mill-kommissjoni tar-referenza li tinsab aktar 'il isfel f'din il-paġna.

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

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

Kif taħdem

1. Wieħed mill-inserzjonisti tiegħek fil-modalità Connect iħallas għal reklama permezz tal-integrazzjoni tiegħek.
2. Ir-reklama tiġi riveduta u approvata — awtomatikament, jew mit-tim tagħna għall-moderazzjoni.
3. Il-parteċipazzjoni tiegħek tinsab fil-kju għall-ħlas awtomatiku fil-wallet tiegħek, bl-istess mekkaniżmu bħal dak tal-programm ta' referenza hawn taħt.

Kundizzjonijiet tal-ħlas

• Portafoll ta' ħlas kripto huwa kkonfigurat fuq il-kont tal-partner tiegħek.
• Mhux meħtieġ KYC min-naħa tiegħek — il-kont tal-partner tiegħek diġà ġie vverifikat meta nħoloq.

Eżempju: qari tal-ishma akkumulati

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
}

Kull kont ta' reklamatur jirċievi sett ta' għodod ta' intelliġenza artifiċjali integrati — ġeneratur ta' kontenut u viżwali għall-irklami, assistent konversazzjonali, konsulent tal-baġit, u awditur estern tas-SEO — imħallsa bil-krediti tal-IA, fuq il-prezz annwali fiss.

Eżempju — ġenera kontenut ta' reklamar

L-istess kategorija u d-deskrizzjoni tan-negozju jipprovdu wkoll il-qawwa lill-ġeneratur tal-immaġni hawn taħt.

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
}

Ġenera viżwal kompatibbli għall-istess reklama:

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
}

Poġġi unità ta' reklamar lesta fuq is-sit tiegħek — mingħajr bżonn ta' kostruzzjoni, mingħajr iframe. Is-skript tirrendi direttament fil-paġna ġewwa Shadow DOM isolat, sabiex l-istili tiegħu qatt ma jinfiltraw fis-sit tiegħek, u l-istili tas-sit tiegħek qatt ma jinfiltraw fih.

Żidha mal-paġna tiegħek

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

B'mod default dan juri l-klassifika pubblika sħiħa tal-kategorija — kull reklamatur fuq il-pjattaforma, mhux biss dawk li ġibt. Biex turi biss ir-reklami minn dawk ir-reklamaturi li ħloqt permezz tal-modalità Connect (dawk li qed jiġġeneraw il-parteċipazzjoni tiegħek), żid data-partner bil-ID tal-partner tiegħek (sibha fuq il-paġna tal-iżviluppaturi fid-dashboard tiegħek):

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

Jekk l-irklamaturi tiegħek jkopru diversi kategoriji, ħalli barra kompletament data-category — bil-data-partner biss, il-widget juri kull wieħed mill-irklami tiegħek f'grilja waħda madwar il-kategoriji kollha, minflok ma jkollok bżonn blokka tal-widget waħda għal kull kategorija:

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

Trid unità b'stil footer ħdejn dik fil-kontenut tiegħek, kull waħda turi reklami differenti? Żid blokka widget t-tieni b'data-layout="compact" (reklama waħda, li tista' tinżel f'pillola żgħira) u issettja data-offset skont kemm reklami diġà turi l-ewwel widget tiegħek:

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

Attributi

Kif il-kummissjoni tar-referiment tal-partner fil-fatt tasal għandhom — il-perċentwal, il-mekkaniżmu ta' ħlas, u l-prekundizzjonijiet.

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
}

Kundizzjonijiet tal-ħlas

• Il-qligħ totali pagabbli tal-pubblikitarju jilħaq l-ammont minimu ta' ħlas.
• Portafoll ta' ħlasijiet kripto huwa kkonfigurat fuq il-kont tagħhom.
• L-istatus KYC tagħhom huwa vverifikat.

Eżempju: qari tad-dħul akkumulat

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
}

Livelli tal-prezz (ħaj)

Aqra direttament minn dan l-endpoint — qatt ma tikteb dawn il-valuri b'mod statiku fil-kodiċi, għax jistgħu jinbidlu min-naħa tagħna. Oħloq picker tal-livell għall-utenti tiegħek minflok kamp ta' ammont b'xejn: kull prezz muri diġà huwa l-ammont eżatt li għandu jiġi mibgħut meta tinħoloq il-ħlas, u l-benefiċċji miftuħa murija hawn jgħidu lill-utenti eżattament x'jiksbu b'dak il-prezz, sabiex jagħżlu prezz li jifhmu minflok jipprova jissuspettaw numru.

It-talbiet huma limitati għal kull ċavetta kull minuta. Kull risposta awtentikata ġġorr l-intestaturi X-RateLimit-Limit, X-RateLimit-Remaining u X-RateLimit-Reset; meta jitla' l-limitu, tirritorna l-kodiċi 429 Too Many Requests flimkien ma' l-intestatura Retry-After.

Ozzjonali, għal kull sieħeb. Sakemm ma żżidx dħul, iċ-ċwievet tiegħek jaċċettaw talbiet minn kwalunkwe IP — id-dħul l-ewwel jibdel iċ-ċwievet kollha ta' dak is-sieħeb għal lista ta' permess biss.

Kull webhook huwa ffirmat b'HMAC-SHA256 billi jintuża sigriet maħruġ darba waħda fil-ħin tal-ħolqien — ivverifika s-sinjatura qabel ma tafda l-payload. L-avvenimenti jintbagħtu biss lill-partner li għandu l-proprjetà tal-inserzjonist relatat.