Документація для розробників

Кожен запит проходить аутентифікацію за допомогою секретного ключа в заголовку «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-аудитор — оплата за які здійснюється за допомогою кредитів AI на додаток до фіксованої річної вартості.

Приклад — створення рекламного контенту

Ця ж категорія та опис бізнесу також використовуються в генераторі зображень, наведеному нижче.

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 із використанням секретного ключа, який видається одноразово під час створення — перед тим, як довіряти вмісту, перевірте підпис. Події надсилаються лише тому партнеру, якому належить відповідний рекламодавець.