Документација за програмери

Секој барање се автентицира со таен клуч во заглавјето 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 со вашиот партнерски 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
}

Нива на цени (во живо)

Читајте во живо од овој краен пункт — никогаш не ги вметнувајте овие вредности директно во кодот, тие можат да се променат од наша страна. Направете избирач на ниво за вашите корисници наместо поле за бесплатен износ: секоја прикажана цена е веќе точниот износ што треба да се испрати при креирање на плаќањето, а прикажаните отклучени придобивки точно им кажуваат на корисниците што добиваат за таа цена, па тие избираат цена што ја разбираат наместо да погодуваат број.

Барањата се ограничени по клуч, по минута. Секој автентициран одговор содржи X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset заглавја; пречекорувањето на ограничувањето враќа 429 Too Many Requests со заглавје Retry-After.

Опционално, по партнер. Сè додека не додадете запис, вашите клучеви прифаќаат барања од која било IP-адреса — првиот запис ги префрла сите клучеви на тој партнер на режим само со дозволена листа.

Секој вебхук е потпишан со HMAC-SHA256 користејќи тајна која се издава само еднаш, при креирањето — проверете го потписот пред да му верувате на плеејлоадот. Настаните се доставуваат само до партнерот кој го поседува соодветниот огласувач.