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

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