Dokumentasi pengembang

Setiap permintaan diautentikasi menggunakan kunci rahasia dalam header Authorization, dengan skema Bearer.

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

Jika kunci API Anda digunakan untuk membuat akun pengiklan bagi pengguna Anda sendiri (mode Connect — lihat bagian Otentikasi di atas), Anda akan mendapatkan bagian dari jumlah yang dibayarkan oleh para pengiklan tersebut untuk iklan mereka. Pembagian di bawah ini diambil secara real-time dari titik akhir yang sama ini, tidak pernah ditetapkan secara permanen, dan sepenuhnya terpisah dari komisi rujukan yang dijelaskan lebih lanjut di bagian bawah halaman ini.

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

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

Cara kerjanya

1. Salah satu pengiklan Anda yang menggunakan mode Connect membayar biaya iklan melalui integrasi Anda.
2. Iklan tersebut ditinjau dan disetujui — baik secara otomatis maupun oleh tim moderasi kami.
3. Bagian Anda sedang dalam antrean untuk pembayaran otomatis ke dompet Anda, dengan mekanisme yang sama seperti program rujukan di bawah ini.

Ketentuan pembayaran

• Dompet pembayaran kripto telah dikonfigurasi pada akun mitra Anda.
• Anda tidak perlu melakukan verifikasi KYC — akun mitra Anda sudah diverifikasi saat dibuat.

Contoh: membaca jumlah saham yang 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 akun pengiklan mendapatkan serangkaian alat AI bawaan — generator konten dan visual iklan, asisten percakapan, penasihat anggaran, serta auditor SEO eksternal — yang dibayar menggunakan kredit AI, di luar biaya tahunan tetap.

Contoh — membuat konten iklan

Kategori dan deskripsi bisnis yang sama juga menjadi dasar bagi generator gambar di bawah ini.

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
}

Buat gambar yang sesuai 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 pakai ke situs Anda — tanpa perlu proses pembuatan, tanpa iframe. Skrip tersebut ditampilkan langsung di halaman dalam Shadow DOM yang terisolasi, sehingga gaya (style) skrip tersebut tidak akan merembes ke situs Anda, dan gaya situs Anda juga tidak akan merembes ke dalamnya.

Tambahkan 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 default, ini menampilkan peringkat publik lengkap untuk kategori tersebut — semua pengiklan di platform ini, bukan hanya yang Anda bawa. Untuk menampilkan hanya iklan dari pengiklan yang Anda buat melalui mode Connect (yang menghasilkan bagian Anda), tambahkan atribut `data-partner` dengan ID mitra Anda (dapat ditemukan di halaman Pengembang pada dasbor 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 mencakup beberapa kategori, hapus atribut `data-category` sepenuhnya — dengan hanya menggunakan atribut `data-partner`, widget akan menampilkan semua iklan Anda dari seluruh kategori dalam satu kisi, alih-alih memerlukan satu blok widget per kategori:

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

Ingin menampilkan unit bergaya footer di samping unit yang ada di dalam konten, dengan masing-masing menampilkan iklan yang berbeda? Tambahkan blok widget kedua dengan atribut data-layout="compact" (satu iklan, dapat dilipat menjadi kotak kecil) dan atribut data-offset disesuaikan dengan jumlah iklan yang sudah ditampilkan 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>

Atribut

Bagaimana komisi rujukan mitra sebenarnya diterima oleh mereka — persentasenya, mekanisme pembayarannya, dan syarat-syaratnya.

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
}

Ketentuan pembayaran

• Total penghasilan yang harus dibayarkan kepada pengiklan telah mencapai jumlah pembayaran minimum.
• Dompet pembayaran kripto telah dikonfigurasi pada akun mereka.
• Status KYC mereka telah diverifikasi.

Contoh: membaca laba yang terakumulasi

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 harga (sudah aktif)

Baca data secara langsung dari titik akhir ini — jangan pernah menetapkan nilai-nilai ini secara permanen, karena nilai-nilai tersebut dapat berubah dari pihak kami. Buatlah pemilih tingkatan untuk pengguna Anda sendiri, bukan kolom jumlah gratis: setiap harga yang ditampilkan sudah merupakan jumlah pasti yang harus dikirim saat membuat pembayaran, dan manfaat yang telah dibuka yang ditampilkan di sini memberi tahu pengguna secara tepat apa yang mereka dapatkan dari harga tersebut, sehingga mereka memilih harga yang mereka pahami, bukan menebak-nebak angka.

Jumlah permintaan dibatasi per kunci, per menit. Setiap respons yang terotentikasi menyertakan header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset; jika melebihi batas, sistem akan mengembalikan kode status 429 Too Many Requests beserta header Retry-After.

Opsional, per mitra. Sampai Anda menambahkan entri, kunci-kunci Anda akan menerima permintaan dari alamat IP mana pun — entri pertama akan mengubah semua kunci mitra tersebut menjadi hanya menerima alamat IP yang ada dalam daftar putih.

Setiap webhook ditandatangani dengan HMAC-SHA256 menggunakan kunci rahasia yang diterbitkan satu kali, pada saat pembuatan — verifikasi tanda tangan tersebut sebelum mempercayai muatan pesan. Peristiwa hanya dikirimkan kepada mitra yang memiliki pengiklan terkait.