Dokumentasi pembangun

Setiap permintaan disahkan dengan kunci rahsia dalam header Autentikasi, menggunakan skema Bearer.

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

Jika kunci API anda mencipta akaun pengiklan untuk pengguna anda sendiri (mod Connect — lihat Autentikasi di atas), anda akan memperoleh bahagian daripada apa yang dibayar oleh pengiklan tersebut untuk iklan mereka. Pembahagian di bawah dibaca secara langsung daripada hujung yang sama ini, tidak pernah di-hardcode, dan sepenuhnya berasingan daripada komisen rujukan yang terdapat lebih bawah pada halaman ini.

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

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

Bagaimana ia berfungsi

1. Salah seorang pengiklan dalam mod Connect anda membayar untuk iklan melalui integrasi anda.
2. Iklan itu disemak dan diluluskan — secara automatik, atau oleh pasukan moderasi kami.
3. Bahagian anda telah diletakkan dalam barisan untuk pembayaran automatik ke dompet anda, mekanisme yang sama seperti program rujukan di bawah.

Syarat pembayaran

• Dompet pembayaran kripto telah dikonfigurasikan pada akaun rakan kongsi anda.
• Tiada KYC diperlukan di pihak anda — akaun rakan kongsi anda telah disemak semasa penciptaannya.

Contoh: membaca saham terkumpul

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
}

Setiap akaun pengiklan mendapat satu set alat AI terbina dalam — penjana kandungan dan visual iklan, pembantu perbualan, penasihat bajet, dan pemeriksa SEO luaran — dibayar dengan kredit AI, di atas harga tahunan tetap.

Contoh — menjana kandungan iklan

Kategori dan keterangan perniagaan yang sama juga memacu penjana imej di bawah.

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
}

Jana visual padanan untuk iklan yang sama:

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
}

Letakkan unit iklan siap guna ke dalam laman anda — tiada langkah pembinaan, tiada iframe. Skrip ini memaparkan terus ke dalam halaman di dalam Shadow DOM terasing, jadi gaya daripadanya tidak akan bocor ke laman anda, dan gaya laman anda tidak akan bocor ke dalamnya.

Tambahkannya ke halaman anda

<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 lalai, ini memaparkan kedudukan awam penuh untuk kategori — setiap pengiklan di platform, bukan hanya pengiklan yang anda bawa masuk. Untuk memaparkan hanya iklan daripada pengiklan yang anda hasilkan melalui mod Connect (yang menjana bahagian anda), tambahkan data-partner dengan ID rakan kongsi anda (temui di halaman Pembangun pada papan pemuka anda sendiri):

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

Jika pengiklan anda merangkumi beberapa kategori, buang sepenuhnya data-category — dengan hanya data-partner, widget akan memaparkan semua iklan anda merentas semua kategori dalam satu grid, tanpa perlu satu blok widget bagi setiap kategori:

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

Mahu unit gaya kaki halaman di sebelah unit dalam kandungan anda, masing-masing memaparkan iklan yang berbeza? Tambah blok widget kedua dengan data-layout="compact" (satu iklan, boleh dikurangkan menjadi pil kecil) dan tetapkan data-offset mengikut berapa banyak iklan yang sudah dipaparkan oleh widget pertama anda:

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

Sifat

Bagaimana komisen rujukan rakan kongsi sebenarnya sampai kepada mereka — peratusannya, mekanisme pembayaran, dan prasyaratnya.

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
}

Syarat pembayaran

• Jumlah keseluruhan pendapatan yang perlu dibayar kepada pengiklan mencapai jumlah pembayaran minimum.
• Dompet pembayaran kripto telah dikonfigurasikan pada akaun mereka.
• Status KYC mereka telah disahkan.

Contoh: membaca pendapatan terkumpul

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
}

Tahap harga (langsung)

Baca secara langsung dari hujung ini — jangan pernah menulis nilai-nilai ini secara tetap, ia boleh berubah di pihak kami. Bina pemilih peringkat untuk pengguna anda sendiri, bukan medan jumlah percuma: setiap harga yang dipaparkan sudah merupakan jumlah tepat yang perlu dihantar semasa membuat pembayaran, dan manfaat terungkap yang dipaparkan di sini memberitahu pengguna dengan tepat apa yang mereka peroleh pada harga tersebut, supaya mereka memilih harga yang mereka fahami, bukan meneka nombor.

Permintaan dihadkan setiap kunci, setiap minit. Setiap respons yang disahkan membawa header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset; melebihi had akan mengembalikan kod ralat 429 Terlalu Banyak Permintaan dengan header Retry-After.

Pilihan, bagi setiap rakan kongsi. Sehingga anda menambah entri, kunci anda menerima permintaan daripada mana-mana IP — entri pertama menukar semua kunci rakan kongsi tersebut kepada senarai benarkan sahaja.

Setiap webhook ditandatangani dengan HMAC-SHA256 menggunakan rahsia yang dikeluarkan sekali sahaja pada masa penciptaan — sahkan tandatangan sebelum mempercayai muatan. Acara hanya dihantar kepada rakan kongsi yang memiliki pengiklan berkaitan.