Dokumentacija za programere

Svaki zahtjev se autentificira tajnim ključem u zaglavlju Autorizacija, koristeći Bearer shemu.

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

Ako vaši API ključevi stvaraju račune oglašivača za vaše korisnike (način povezivanja — vidi Autentifikaciju gore), zarađujete udio u onome što ti oglašivači plaćaju za svoje oglase. Podjela u nastavku čita se uživo s iste krajnje točke, nikada nije fiksno kodirana i potpuno je odvojena od provizije za preporuke niže na ovoj stranici.

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

Kako radi

1. Jedan od vaših oglašivača u Connect-modeu plaća oglas putem vaše integracije.
2. Oglas se pregledava i odobrava — automatski ili od strane našeg tima za moderaciju.
3. Vaš udio je stavljen u red za automatsku isplatu na vaš novčanik, isti mehanizam kao i kod programa preporuka u nastavku.

Uvjeti isplate

• Na vašem partnerskom računu konfiguriran je kripto novčanik za isplate.
• S vaše strane nije potrebna provjera KYC — vaš partnerski račun je već provjeren prilikom otvaranja.

Primjer: čitanje akumuliranih udjela

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
}

Svaki oglašivački račun dobiva skup ugrađenih AI alata — generator sadržaja i vizuala za oglase, konverzacijskog asistenta, savjetnika za proračun i vanjskog SEO revizora — koji se plaćaju AI kreditima, uz fiksnu godišnju cijenu.

Primjer — generirajte sadržaj oglasa

Ista kategorija i opis poslovanja također pokreću generator slika u nastavku.

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
}

Generirajte odgovarajući vizual za isti oglas:

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
}

Postavite gotovu reklamnu jedinicu na svoju web-stranicu — bez faze izrade, bez iframea. Skripta se izravno renderira na stranicu unutar izoliranog Shadow DOM-a, pa se njezini stilovi nikada ne prenose na vašu stranicu, a stilovi vaše stranice se nikada ne prenose na nju.

Dodaj to na svoju stranicu

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

Po zadanom prikazuje se potpuni javni poredak za kategoriju — svi oglašivači na platformi, a ne samo oni koje ste doveli. Da biste prikazali samo oglase oglašivača koje ste kreirali putem Connect moda (oni koji generiraju vaš udio), dodajte atribut data-partner s ID-om vašeg partnera (pronađite ga na stranici Developera na svojoj nadzornoj ploči):

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

Ako vaši oglašivači obuhvaćaju više kategorija, potpuno uklonite data-category — s samo data-partnerom widget prikazuje sve vaše oglase iz svih kategorija u jednoj mreži, umjesto da vam treba po jedan blok widgeta za svaku kategoriju:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Želite li uz postojeću jedinicu u sadržaju još jednu u stilu podnožja, pri čemu svaka prikazuje različite oglase? Dodajte drugi blok widgeta s atributom data-layout="compact" (jedan oglas, sklopiv u malu pilulu) i postavite data-offset na broj oglasa koje vaš prvi widget već prikazuje:

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

Atributi

Kako partnerova provizija za preporuku zapravo stiže do njega — postotak, mehanizam isplate i preduvjeti.

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
}

Uvjeti isplate

• Ukupna isplativa zarada oglašivača doseže minimalni iznos isplate.
• Na njihovom je računu konfiguriran kripto novčanik za isplatu.
• Njihov KYC status je provjeren.

Primjer: čitanje akumulirane zarade

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
}

Razine cijena (uživo)

Čitaj uživo s ovog krajnjeg točka — nikada ne upisuj ove vrijednosti izravno u kod, mogu se promijeniti s naše strane. Izradite odabirač razina za svoje korisnike umjesto polja za slobodan iznos: svaka prikazana cijena već je točan iznos za slanje prilikom izrade uplate, a ovdje prikazane otključane pogodnosti točno govore korisnicima što ta cijena uključuje, pa odabiru cijenu koju razumiju umjesto da nagađaju iznos.

Zahtjevi su ograničeni po ključu u minuti. Svaki autentificirani odgovor nosi zaglavlja X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset; prekoračenje ograničenja vraća kôd 429 Previše zahtjeva s zaglavljem Retry-After.

Opcionalno, po partneru. Dok ne dodate unos, vaši ključevi prihvaćaju zahtjeve s bilo koje IP adrese — prvi unos prebacuje sve ključeve tog partnera na režim isključivo dopuštenog popisa.

Svaki webhook je potpisan HMAC-SHA256 pomoću tajne koja se izdaje samo jednom pri stvaranju — provjerite potpis prije povjerenja u teret. Događaji se isporučuju samo partneru koji posjeduje odgovarajućeg oglašivača.