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

Сваки захтев се аутентикује тајним кључем у заглављу 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-mode режиму плаћа оглас преко ваше интеграције.
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-ом вашег партнера (пронађите га на страници за програмере на свом контролном табли):

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

Опционално, по партнеру. Док не додате унос, ваши кључеви прихватају захтеве са било које ИП адресе — први унос пребацује све кључеве тог партнера на режим искључиво са одобрене листе.

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