Dasturchi hujjatlari

Har bir so'rov Authorization sarlavhasidagi Bearer sxemasi yordamida maxfiy kalit bilan autentifikatsiya qilinadi.

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

Agar API kalitlaringiz o'z foydalanuvchilaringiz uchun reklama beruvchi hisoblarini yaratadigan bo'lsa (Connect rejimi — yuqoridagi Avtentifikatsiya bo'limiga qarang), siz o'sha reklama beruvchilar o'z reklamalari uchun to'laydigan summadan ulush olasiz. Quyidagi ulush shu bir xil endpointdan jonli ravishda o'qiladi, hech qachon qattiq kodlanmaydi va bu sahifaning keyingi qismidagi tavsiya komissiyasidan butunlay alohida.

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

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

U qanday ishlaydi

1. Connect-rejimidagi reklama beruvchilaringizdan biri integratsiyangiz orqali reklama uchun to'lov qiladi.
2. Reklama ko'rib chiqilib, ma'qullanadi — avtomatik ravishda yoki moderatsiya jamoasi tomonidan.
3. Sizning ulushingiz avtomatik ravishda hamyoningizga to'lov uchun navbatga qo'yildi, bu quyidagi tavsiya dasturidagi mexanizmga o'xshaydi.

To'lov shartlari

• Sizning hamkor hisobingizda kriptovalyuta to'lov hamyon sozlangan.
• Siz tomondan KYC talab qilinmaydi — hamkor hisobingiz yaratilganda allaqachon tekshirilgan.

Misol: to'plangan ulushlarni o'qish

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
}

Har bir reklama beruvchi hisobiga o'rnatilgan sun'iy intellekt vositalar to'plami beriladi — reklama kontenti va vizual generator, suhbatli yordamchi, byudjet bo'yicha maslahatchi va tashqi SEO auditori — ularning barchasi yillik bir xil to'lovga qo'shimcha ravishda sun'iy intellekt kreditlari evaziga to'lanadi.

Misol — reklama kontentini yaratish

Xuddi shu toifa va biznes tavsifi quyidagi tasvir yaratuvchisini ham quvvatlaydi.

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
}

Xuddi shu reklama uchun mos vizual yarating:

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
}

Tayyor reklama blokini o'zingizning saytga tortib tushiring — hech qanday o'rnatish bosqichi yoki iframe talab etilmaydi. Skript izolyatsiyalangan Shadow DOM ichida bevosita sahifada render qilinadi, shuning uchun uning uslublari hech qachon sizning saytga o'tmaydi, va sizning saytingiz uslublari ham unga o'tmaydi.

Uni sahifangizga qo'shing

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

Oddiy holatda bu kategoriya bo'yicha to'liq ommaviy reytingni ko'rsatadi — platformadagi barcha reklama beruvchilarni, faqat siz jalb qilganlarini emas. Connect rejimi orqali yaratgan reklama beruvchilaringizning (sizning ulushingizni hosil qilayotgan) reklamalarini ko'rsatish uchun data-partner atributiga o'zingizning hamkor ID-ingizni qo'shing (uni o'z boshqaruv panelingizdagi Ishlab chiquvchilar sahifasida topishingiz mumkin):

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

Agar reklamachilaringiz bir nechta toifalarga kirsa, data-category atributini butunlay olib tashlang — faqat data-partner bilan vidjet barcha toifalardagi reklamalaringizni bitta tarmoqda ko'rsatadi, har bir toifa uchun alohida vidjet bloki qo'yishga hojat yo'q:

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

Mavzu ichidagi reklamangiz yonida, har biri turli reklamalarni ko'rsatadigan footer-uslubidagi blokni ham qo'shmoqchimisiz? Ikkinchi widget blokini data-layout="compact" (bitta reklama, kichik pillaga siqib qo'yilishi mumkin) va data-offset parametrini birinchi widgetingiz allaqachon nechta reklama ko'rsatayotganiga teng qilib o'rnating:

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

Xususiyatlar

Sherikning tavsiya komissiyasi ularga qanday yetib boradi — foizi, to'lov mexanizmi va oldindan belgilangan shartlari.

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
}

To'lov shartlari

• Reklama beruvchining to'lanishi kerak bo'lgan jami daromadi minimal to'lov miqdoriga yetdi.
• Ularning hisobida kriptovalyuta to'lov hamyon sozlangan.
• Ularning KYC maqomi tasdiqlangan.

Misol: to'plangan daromadlarni o'qish

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
}

Narxlash darajalari (jonli)

Ushbu endpointdan jonli o'qing — bu qiymatlarni hech qachon qattiq kodlamang, ular biz tomondan o'zgarishi mumkin. Bepul miqdor maydoni o'rniga foydalanuvchilaringiz uchun bosqich tanlovchisini yarating: ko'rsatilgan har bir narx to'lovni yaratishda yuborilishi kerak bo'lgan aniq summadir, bu yerda ko'rsatilgan ochilgan imtiyozlar esa foydalanuvchilarga aynan shu narx evaziga nimaga ega bo'lishlarini ko'rsatadi, shunda ular raqamni taxmin qilish o'rniga tushunadigan narxni tanlaydilar.

Har bir kalit bo'yicha daqiqada so'rovlar soni cheklangan. Har bir autentifikatsiyalangan javob X-RateLimit-Limit, X-RateLimit-Remaining va X-RateLimit-Reset sarlavhalarini o'z ichiga oladi; limitni oshirish 429 Too Many Requests xatosini Retry-After sarlavhasi bilan qaytaradi.

Ixtiyoriy, har bir hamkor uchun. Siz yozuv qo'shmaguningizcha, kalitlaringiz har qanday IP manzildan keladigan so'rovlarni qabul qiladi — birinchi yozuv esa o'sha hamkorning barcha kalitlarini faqat ruxsat berilgan manzillardan keladigan so'rovlarni qabul qiladigan holatga o'tkazadi.

Har bir webhook yaratilgan paytda bir marta berilgan sirli kalit yordamida HMAC-SHA256 bilan imzolanadi — yuklamaga ishonishdan oldin imzoni tekshiring. Voqealar faqat tegishli reklama beruvchiga egalik qiluvchi hamkorga yetkaziladi.