Utviklerdokumentasjon

Hver forespørsel autentiseres med en hemmelig nøkkel i «Authorization»-overskriften, ved hjelp av «Bearer»-ordningen.

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

Hvis API-nøklene dine oppretter annonsørkontoer for dine egne brukere (Connect-modus – se «Autentisering» ovenfor), tjener du en andel av det disse annonsørene betaler for annonsene sine. Fordelingen nedenfor hentes i sanntid fra nettopp dette endepunktet, er aldri fastkodet og er helt adskilt fra henvisningsprovisjonen lenger ned på denne siden.

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

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

Slik fungerer det

1. En av annonsørene dine i Connect-modus betaler for en annonse via integrasjonen din.
2. Annonsen blir gjennomgått og godkjent – enten automatisk eller av vårt modereringsteam.
3. Andelen din står i kø for automatisk utbetaling til lommeboken din – det er samme mekanisme som i henvisningsprogrammet nedenfor.

Utbetalingsvilkår

• Det er opprettet en lommebok for utbetaling av kryptovaluta på partnerkontoen din.
• Du trenger ikke å gjennomføre noen KYC-verifisering – partnerkontoen din er allerede godkjent ved opprettelsen.

Eksempel: å lese antall akkumulerte aksjer

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
}

Hver annonsørkonto får tilgang til en rekke innebygde AI-verktøy – en generator for annonseinnhold og grafikk, en samtaleassistent, en budsjettrådgiver og en ekstern SEO-revisor – som betales med AI-kreditter, i tillegg til den faste årsprisen.

Eksempel — generere annonseinnhold

Den samme kategorien og virksomhetsbeskrivelsen ligger også til grunn for bildegeneratoren nedenfor.

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
}

Lag et tilhørende bilde til den samme annonsen:

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
}

Legg inn en ferdiglaget annonseenhet på din egen nettside – uten å måtte bygge noe selv og uten iframe. Skriptet vises direkte på siden inne i et isolert Shadow DOM, slik at stilene fra annonseenheten aldri påvirker nettstedet ditt, og stilene fra nettstedet ditt aldri påvirker annonseenheten.

Legg det til på siden din

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

Som standard vises her den fullstendige offentlige rangeringen for kategorien – alle annonsører på plattformen, ikke bare de du har hentet inn. For å vise kun annonsene fra annonsører du har opprettet via Connect-modus (de som genererer andelen din), legger du til «data-partner» med partner-ID-en din (du finner den på «Utviklere»-siden i ditt eget dashbord):

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

Hvis annonsørene dine spenner over flere kategorier, bør du fjerne «data-category» helt — med bare «data-partner» viser widgeten alle annonsene dine på tvers av alle kategoriene i ett rutenett, i stedet for at du trenger én widgetblokk per kategori:

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

Vil du ha en enhet i bunntekststil ved siden av den som vises i innholdet, slik at hver av dem viser forskjellige annonser? Legg til en ny widgetblokk med data-layout="compact" (én enkelt annonse, som kan skjules til en liten «pille») og data-offset satt til antall annonser som den første widgeten din allerede viser:

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

Egenskaper

Hvordan en partners henvisningsprovisjon faktisk utbetales til vedkommende — prosentandelen, utbetalingsmåten og forutsetningene.

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
}

Utbetalingsvilkår

• Annonsørens samlede utbetalbare inntekter når minimumsbeløpet for utbetaling.
• Det er opprettet en lommebok for utbetaling av kryptovaluta på kontoen deres.
• Deres KYC-status er bekreftet.

Eksempel: oppgaver om akkumulert overskudd

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
}

Prisnivåer (live)

Les verdiene direkte fra dette endepunktet — du må aldri hardkode disse verdiene, da de kan endres fra vår side. Lag en prisvelger for dine egne brukere i stedet for et felt for fritt valgt beløp: hver pris som vises er allerede det nøyaktige beløpet som skal sendes når betalingen opprettes, og de tilgjengelige fordelene som vises her forteller brukerne nøyaktig hva de får for den prisen, slik at de velger en pris de forstår i stedet for å gjette seg frem til et tall.

Det er satt en grense for antall forespørsler per nøkkel per minutt. Hvert godkjent svar inneholder overskriftene X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset. Hvis grensen overskrides, returneres feilkoden 429 Too Many Requests sammen med overskriften Retry-After.

Valgfritt, per partner. Inntil du legger til en oppføring, godtar nøklene dine forespørsler fra alle IP-adresser — den første oppføringen endrer alle nøklene til den aktuelle partneren slik at de kun tillater tilgang fra adresser på tillatelseslisten.

Hver webhook signeres med HMAC-SHA256 ved hjelp av en hemmelig nøkkel som utstedes én gang ved opprettelsen – sjekk signaturen før du stoler på innholdet. Hendelser leveres kun til den partneren som eier den tilknyttede annonsøren.