Dokumentaro por programisto

Ĉiu peto estas aŭtentigita per sekreta ŝlosilo en la aŭtoriza kaplinio, uzante la Bearer-skemon.

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

Se viaj API-ŝlosiloj kreas reklamanto-kontojn por viaj propraj uzantoj (Konekta reĝimo — vidu Aŭtentikigon supre), vi gajnas parton de tio, kion tiuj reklamantoj pagas por siaj anoncoj. La suba disdono estas legata vive de ĉi tiu sama finpunkto, neniam fikskodita, kaj tute aparta de la referenca komisiono pli malsupre sur ĉi tiu paĝo.

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

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

Kiel ĝi funkcias

1. Unu el viaj Connect-reklamantoj pagas por anonco per via integriĝo.
2. La anonco estas reviziita kaj aprobita — aŭtomate, aŭ de nia moderiga teamo.
3. Via parto estas en la vico por aŭtomata pago al via monujo, la sama mekanismo kiel en la suba referenca programo.

Pagokondiĉoj

• Kripta elpaga monujo estas agordita en via partnera konto.
• Ne necesas KYC de via flanko — via partnera konto jam estis kontrolita ĉe ĝia kreo.

Ekzemplo: legado de akumulitaj partoj

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
}

Ĉiu reklamanta konto ricevas aron da enkonstruitaj AI-iloj — generilon de reklamaj enhavoj kaj vidaj elementoj, konversacian asistanton, buĝetan konsiliston kaj eksteran SEO-revizoron — pagatajn per AI-kreditoj krom la fiksa jara kotizo.

Ekzemplo — generi reklaman enhavon

La sama kategorio kaj komerca priskribo ankaŭ funkciigas la bildogeneratoron sube.

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
}

Kreu kongruan vidigilon por la sama reklamo:

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
}

Metu pretfaran reklaman unuon sur vian propran retejon — sen konstrua paŝo, sen iframe. La skripto redonas sin rekte en la paĝo ene de izolita Shadow DOM, do ĝiaj stiloj neniam likas en vian retejon, kaj la stiloj de via retejo neniam likas en ĝin.

Aldonu ĝin al via paĝo

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

Defaŭlte ĉi tio montras la plenan publikan rangigon de la kategorio — ĉiun reklamanton sur la platformo, ne nur tiujn, kiujn vi alportis. Por montri nur la anoncojn de reklamantoj, kiujn vi kreis per la konekta reĝimo (tiuj, kiuj generas vian parton), aldonu data-partner kun via partnera ID (trovu ĝin sur la disvolvantoj-paĝo de via propra panelo):

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

Se viaj reklamantoj etendiĝas tra pluraj kategorioj, forigu tute la atributon data-category — kun nur data-partner la videto montras ĉiujn viajn reklamojn tra ĉiuj kategorioj en unu krado, anstataŭ bezoni po unu videtan blokon por ĉiu kategorio:

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

Ĉu vi volas piedlinian unuon apud via enhava unu, ĉiu montranta malsamajn reklamojn? Aldonu duan vidjetblokon kun data-layout="compact" (unu reklamo, kunpremebla en malgrandan pilolon) kaj data-offset agordita al kiom da reklamoj via unua vidjeto jam montras:

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

Atributoj

Kiel la komisiono pro refero de partnero fakte atingas ilin — la procento, la pagmekanismo kaj la antaŭkondiĉoj.

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
}

Pagokondiĉoj

• La totalaj pagendaj enspezoj de la reklamanto atingas la minimuman pagsumon.
• Kripta pagosako estas agordita en ilia konto.
• Ilia KYC-statuso estas konfirmita.

Ekzemplo: legado de akumulitaj enspezoj

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
}

Prezniveloj (aktiva)

Legu rekte de ĉi tiu finpunkto — neniam fikskodigu ĉi tiujn valorojn, ili povas ŝanĝiĝi ĉe nia flanko. Konstruu nivel-elektilon por viaj propraj uzantoj anstataŭ kampo por libera sumo: ĉiu montrata prezo jam estas la preciza sumo sendota kiam oni kreas la pagon, kaj la ĉi tie montrataj malŝlositaj avantaĝoj precize informas uzantojn, kion tiu prezo al ili donas, tiel ke ili elektas prezon, kiun ili komprenas, anstataŭ diveni nombron.

Petooj estas limigitaj per ŝlosilo je minuto. Ĉiu aŭtentigita respondo portas la kapliniojn X-RateLimit-Limit, X-RateLimit-Remaining kaj X-RateLimit-Reset; superi la limon redonas 429 Tro Multaj Petooj kun la kaplinio Retry-After.

Laŭvola, por ĉiu partnero. Ĝis vi aldonos eniron, viaj ŝlosiloj akceptas petojn de iu ajn IP-adreso — la unua eniro ŝanĝas ĉiujn ŝlosilojn de tiu partnero al nur-permeslisto.

Ĉiu webhook estas subskribita per HMAC-SHA256 uzante sekretejon eldonitan unufoje ĉe ĝia kreo — kontrolu la subskribon antaŭ ol fidi la ŝarĝaĵon. Eventoj estas liverataj nur al la partnero, kiu posedas la rilatan reklamanton.