Иштеп чыгуучунун документациясы

Ар бир сурам Authorization башындагы сырдуу ачкыч менен Bearer схемасын колдонуп аутентификацияланат.

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

Эгерде сиздин API ачкычтарыңыз өз колдонуучуларыңыз үчүн жарнама берүүчү аккаунттарды түзсө (Connect режими — жогорудагы Authentication бөлүмүнө караңыз), анда ошол жарнама берүүчүлөр жарнамалары үчүн төлөгөн сумманын бир бөлүгүн аласыз. Төмөндөгү бөлүштүрүү ушул эле endpointдон түз окулат, эч качан катуу коддолбойт жана бул барактын төмөн жагындагы рефералдык комиссиядан толугу менен өзүнчө.

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

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

Ал кандайча иштейт

1. Сиздин Connect-режиминдеги жарнама берүүчүлөрдүн бири сиздин интеграцияңыз аркылуу жарнама үчүн төлөйт.
2. Жарнама каралып, бекитилет — автоматтык түрдө же модерация командасы тарабынан.
3. Сиздин үлүшүңүз капчыгыңызга автоматтык төлөнүү үчүн кезекке коюлду, бул ылдыйдагы рефералдык программа сыяктуу эле механизм.

Төлөө шарттары

• Сиздин өнөктөш эсебиңизде крипто төлөм капчыгы конфигурацияланган.
• Сиздин тараптан KYC талап кылынбайт — өнөктөш эсебиңиз түзүлгөндө эле текшерилген.

Мисал: топтолгон акцияларды окуу

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
}

Ар бир жарнама берүүчүнүн аккаунтуна ички жасалма интеллект куралдарынын топтому берилет — жарнама мазмунун жана визуалдарын генерациялоочу, сүйлөшүүчү ассистент, бюджет боюнча кеңешчи жана тышкы SEO аудитору — алар жылдык бирдиктүү баага кошумча жасалма интеллект кредиттери менен төлөнөт.

Мисал — жарнама мазмунун түзүү

Ошол эле категория жана бизнес сүрөттөлүшү төмөндөгү сүрөт генераторун да камсыз кылат.

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
}

Ошол эле жарнама үчүн шайкеш визуал түзүңүз:

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
}

Даяр жарнама блогун өз сайтыңызга түз эле коюп коюңуз — куруунун кереги жок, iframe да керек эмес. Скрипт бетке түздөн-түз өзүнчө Shadow DOM ичинде көрсөтүлөт, ошондуктан анын стилдери сиздин сайттын стилдерине аралашпайт, сиздин сайттын стилдери да ага аралашпайт.

Муну баракчаңызга кошуңуз

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

Стандарт боюнча бул категориянын толук коомдук рейтингин көрсөтөт — платформадагы ар бир жарнама берүүчү, сиз алып келгендер гана эмес. Connect режими аркылуу түзгөн жарнама берүүчүлөрдүн гана (сиздин үлүшүңүздү түзгөндөрдүн) жарнамаларын көрсөтүү үчүн data-partner параметрин өнөктөш IDиңиз менен кошуңуз (аны өзүңүздүн башкаруу панелиңиздин Developers барагынан табыңыз):

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

Эгерде сиздин жарнама берүүчүлөрүңүз бир нече категорияга кирсе, data-category параметрин толугу менен алып салыңыз — data-partner гана колдонсоңуз, виджет ар бир категориядагы бардык жарнамаларыңызды бир эле тордо көрсөтөт, ар бир категория үчүн өзүнчө виджет блогу талап кылынбайт:

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

Мазмундагы бирдикке кошумча, ар башка жарнамаларды көрсөтө турган футер стилиндеги бирдикти кошкуңуз келеби? data-layout="compact" (бир жарнама, кичинекей «пилл» формасында кыскартылып көрсөтүлө турган) жана data-offset параметрин биринчи виджеттеги жарнамалардын санына жараша орнотулган экинчи виджет блогун кошуңуз:

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

Мүнөздөмөлөр

Партнердин тааныштыруу комиссиясы чындап эле кантип ага жетет — пайызы, төлөө механизми жана алдын ала шарттары.

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
}

Төлөө шарттары

• Жарнама берүүчүнүн төлөнүүчү жалпы кирешеси минималдуу төлөө суммасына жетти.
• Алардын эсебинде крипто төлөм капчыгы орнотулган.
• Алардын KYC статусу текшерилген.

Мисал: топтолгон кирешелерди окуу

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
}

Баа деңгээлдери (жандуу)

Бул endpointтен түз окуңуз — бул маанилерди эч качан түз кодго киргизбеңиз, алар биздин жактан өзгөрүшү мүмкүн. Акысыз сумма талаасынын ордуна колдонуучуларыңыз үчүн баа деңгээлин тандагыч түзүңүз: көрсөтүлгөн ар бир баа төлөмдү түзүүдө жөнөтүлө турган так сумма болуп саналат, ал эми бул жерде ачылган артыкчылыктар колдонуучуларга ошол баанын аларга эмнени берерин так көрсөтөт, ошондуктан алар санды болжоп эмес, түшүнгөн бааны тандашат.

Сурамдар ар бир ачкыч үчүн мүнөтүнө чектелет. Ар бир аутентификацияланган жооп X-RateLimit-Limit, X-RateLimit-Remaining жана X-RateLimit-Reset заголовокторун камтыйт; лимиттен ашса, Retry-After заголовогу менен 429 Too Many Requests катасы кайтарылат.

Ар бир шериктеш үчүн ыктыярдуу. Жазуу кошконго чейин сиздин ачкычтарыңыз каалаган IP даректен сурамдарды кабыл алат — биринчи жазуу ошол шериктештин бардык ачкычтарын гана уруксатталган тизмеге өткөрөт.

Ар бир вебхук түзүлгөн учурда бир жолу берилген сырдуу ачкычты колдонуп HMAC-SHA256 менен кол коюлат — жүктөмөгө ишенүүдөн мурун кол коюуну текшериңиз. Иш-чаралар тиешелүү жарнама берүүчүнүн ээси болгон өнөктөшкө гана жеткирилет.