Дакументацыя для распрацоўшчыкаў

Кожны запыт аўтэнтыфікуецца з дапамогай сакрэтнага ключа ў загалоўку Authorization, з выкарыстаннем схемы Bearer.

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

Калі вашы API-ключы ствараюць рэкламадаўчыя акаўнты для вашых уласных карыстальнікаў (рэжым Connect — гл. «Аўтэнтыфікацыя» вышэй), вы атрымліваеце долю ад таго, што гэтыя рэкламадаўцы плацяць за свае аб'явы. Доля, пазначаная ніжэй, запытваецца ў рэжыме рэальнага часу з таго ж эндпойнта, ніколі не ўводзіцца ўстаноўкай і цалкам аддзелена ад рэферальнай камісіі, размешчанай ніжэй на гэтай старонцы.

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 з ідэнтыфікатарам вашага партнёра (знойдзіце яго на старонцы распрацоўшчыкаў у вашым уласным кабінеце):

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

Цэнавыя пазіцыі (ужывую)

Чытайце з гэтага эндпойнта ў рэальным часе — ніколі не ўбудоўвайце гэтыя значэнні ў код, яны могуць змяніцца з нашага боку. Стварыце выбарнік узроўняў для ўласных карыстальнікаў замест поля з бясплатнай сумай: кожная паказаная цана — гэта ўжо дакладная сума, якую трэба перавесці пры стварэнні аплаты, а адлюстраваныя тут разблакаваныя перавагі дакладна паказваюць карыстальнікам, што ўключае кожная цана, таму яны выбіраюць цану, якую разумеюць, замест таго каб здагадвацца з лікам.

Колькасць запытаў абмежаваная па ключы ў хвіліну. Кожны аўтэнтыфікаваны адказ змяшчае загалоўкі X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset; перавышэнне ліміту вядзе да вяртання кода 429 Too Many Requests з загалоўкам Retry-After.

Неабавязкова, для партнёра. Пакуль вы не дадасце запіс, вашы ключы прымаюць запыты з любога IP-адраса — першы запіс пераводзіць усе ключы гэтага партнёра толькі на рэжым дазволенага спіса.

Кожны вэбхук падпісваецца з дапамогай HMAC-SHA256 з выкарыстаннем сакрэтнага ключа, які выдаецца адзін раз пры стварэнні — праверце подпіс, перш чым давяраць грузу. Падзеі дастаўляюцца толькі таму партнёру, які з'яўляецца ўладальнікам адпаведнага рэкламадаўцы.