Dokumentasi pangembang

Saben panjalukan diotentikasi nganggo kunci rahasia ing header Otorisasi, nggunakake skema Bearer.

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

Yen kunci API sampeyan nggawe akun pengiklan kanggo pangguna sampeyan dhéwé (mode Connect — delengen Autentikasi ing ndhuwur), sampeyan bakal entuk bagéan saka apa sing dibayar para pengiklan mau kanggo iklané. Bagi-bagi ing ngisor iki diwaca langsung saka endpoint sing padha, ora tau dikode keras, lan sakabehe kapisah saka komisi rujukan sing ana ing ngisor kaca iki.

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

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

Carane kerjane

1. Salah siji pengiklan ing mode Connect mbayar iklan liwat integrasimu.
2. Iklan kasebut ditinjau lan disetujoni — kanthi otomatis, utawa dening tim moderasi kita.
3. Pangsa sampeyan wis ana ing antrian kanggo pambayaran otomatis menyang dompet sampeyan, mekanisme sing padha karo program rujukan ing ngisor iki.

Kahanan pambayaran

• Dompet pembayaran kripto wis diatur ing akun mitramu.
• Ora perlu KYC saka sisih sampeyan — akun mitra sampeyan wis diverifikasi nalika digawe.

Tuladha: maca saham sing wis ditumpukake

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
}

Saben akun pengiklan entuk sakumpulan piranti AI bawaan — generator konten iklan lan visual, asisten obrolan, penasihat anggaran, lan auditor SEO eksternal — sing mbayar nganggo kredit AI, saliyane rega tahunan sing tetep.

Tuladha — ngasilake konten iklan

Kategori sing padha lan katrangan bisnis uga nyokong generator gambar ing ngisor iki.

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
}

Gawé visual sing cocog kanggo iklan sing padha:

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
}

Selehake unit iklan siap pakai ing situsmu — ora perlu nggawe, ora perlu iframe. Skrip iki nampilake langsung ing kaca liwat Shadow DOM sing kapisah, supaya gaya saka iklan ora bakal mlebu situsmu, lan gaya situsmu uga ora bakal mlebu ing iklan.

Tambahna ing kaca sampeyan

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

Secara baku, iki nampilake peringkat umum lengkap kanggo kategori — saben pengiklan ing platform, ora mung sing wis sampeyan lebokake. Kanggo nampilake mung iklan saka pengiklan sing sampeyan gawe liwat mode Connect (sing ngasilake bagéan sampeyan), tambahi data-partner nganggo ID mitra sampeyan (goleki ing kaca Pengembang ing dasbor sampeyan):

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

Yen pengiklan sampeyan nyakup pirang-pirang kategori, buwang data-category sakabehe — mung nganggo data-partner, widget bakal nampilake kabeh iklan sampeyan saka kabeh kategori ing siji grid, tinimbang kudu siji blok widget kanggo saben kategori:

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

Kowe pengin unit gaya footer ing jejere unit ing kontenmu, saben nuduhake iklan sing beda? Tambahna blok widget kapindho nganggo data-layout="compact" (siji iklan, bisa digulung dadi pil cilik) lan data-offset disetel miturut pira iklan sing wis ditampilake dening widget kapisanmu:

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

Sipat-sipat

Kepiye komisi rujukan saka mitra sejatine tekan marang dheweke — persentase, mekanisme pambayaran, lan prasyarat.

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
}

Kahanan pambayaran

• Total penghasilan sing kudu dibayar dening pengiklan wis tekan jumlah pambayaran minimal.
• Dompet pembayaran kripto wis diatur ing akuné.
• Status KYC-e wis diverifikasi.

Tuladha: maca penghasilan sing wis numpuk

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
}

Tingkat rega (langsung)

Waca langsung saka endpoint iki — aja tau hardcode nilai-nilai iki, amarga bisa owah saka sisih kita. Gawé pemilih tingkat kanggo pangguna sampeyan tinimbang kolom jumlah gratis: saben rega sing ditampilake wis jumlah pas sing kudu dikirim nalika nggawe pambayaran, lan keuntungan sing wis kabuka ing kene nerangake persis apa sing dipikolehi pangguna saka rega kasebut, supaya padha milih rega sing dipahami tinimbang nebak angka.

Panjaluk diwatesi saben kunci saben menit. Saben tanggapan sing wis diotentikasi nggawa header X-RateLimit-Limit, X-RateLimit-Remaining, lan X-RateLimit-Reset; yen ngluwihi watesan bakal mbalekake kode kesalahan 429 Too Many Requests karo header Retry-After.

Opsional, saben mitra. Nganti sampeyan nambah entri, kunci sampeyan nampa panyuwunan saka sembarang IP — entri pisanan ngganti kabeh kunci mitra kasebut dadi mung ing dhaptar ijin.

Saben webhook ditandhani nganggo HMAC-SHA256 kanthi rahasia sing mung diwenehake sepisan nalika digawe — priksa tandha tangan sadurunge percaya karo muatan. Acara mung dikirim menyang mitra sing nduwèni pengiklan sing cocog.