Dokumentation til udviklere

Hver anmodning godkendes ved hjælp af en hemmelig nøgle i Authorization-headeren ved brug af Bearer-metoden.

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

Hvis dine API-nøgler opretter annoncørkonti for dine egne brugere (Connect-tilstand — se »Godkendelse« ovenfor), får du en andel af det, som disse annoncører betaler for deres annoncer. Fordelingen nedenfor hentes i realtid fra netop dette endpoint, er aldrig fastkodet og er helt adskilt fra henvisningsprovisionen længere nede på denne side.

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

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

Sådan fungerer det

1. En af dine annoncører i Connect-tilstand betaler for en annonce via din integration.
2. Annoncen gennemgås og godkendes – enten automatisk eller af vores moderationsteam.
3. Din andel er sat i kø til automatisk udbetaling til din tegnebog – det fungerer på samme måde som henvisningsprogrammet nedenfor.

Udbetalingsbetingelser

• Der er oprettet en kryptovaluta-udbetalingslommebog på din partnerkonto.
• Der kræves ingen KYC-verifikation fra din side — din partnerkonto er allerede blevet godkendt ved oprettelsen.

Eksempel: aflæsning af akkumulerede aktier

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 annoncørkonto får adgang til en række indbyggede AI-værktøjer — en generator til annonceindhold og -grafik, en dialogassistent, en budgetrådgiver og en ekstern SEO-revisor — som betales med AI-kreditter ud over den faste årlige pris.

Eksempel — generer annonceindhold

Den samme kategori og virksomhedsbeskrivelse ligger også til grund for billedgeneratoren 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
}

Opret et tilhørende billede til den samme annonce:

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
}

Indsæt en færdiglavet annonceblok på din egen hjemmeside — ingen opsætning, ingen iframe. Skriptet vises direkte på siden inden for et isoleret Shadow DOM, så dets stilarter aldrig påvirker din hjemmeside, og din hjemmesides stilarter aldrig påvirker det.

Føj det til din side

<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 den fulde offentlige rangliste for kategorien her — alle annoncører på platformen, ikke kun dem, du har tilført. For kun at vise annoncer fra annoncører, du har oprettet via Connect-tilstand (dem, der genererer din andel), skal du tilføje »data-partner« sammen med dit partner-ID (du finder det på siden »Udviklere« på dit eget dashboard):

<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 dine annoncører dækker flere kategorier, skal du helt udelade »data-category« — ved kun at bruge »data-partner« viser widgeten alle dine annoncer på tværs af alle kategorier i ét gitter, i stedet for at der skal bruges én widgetblok pr. 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 have en enhed i fodtekstformat ved siden af den, der vises i indholdet, hvor hver viser forskellige annoncer? Tilføj en anden widgetblok med data-layout="compact" (en enkelt annonce, der kan foldes sammen til en lille pille) og data-offset indstillet til det antal annoncer, som din første widget 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>

Egenskaber

Hvordan en partners henvisningsprovision rent faktisk udbetales til vedkommende — procentdelen, udbetalingsmekanismen og forudsætningerne.

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
}

Udbetalingsbetingelser

• Annoncørens samlede indtjening, der skal udbetales, når op til minimumsudbetalingsbeløbet.
• Der er oprettet en kryptovaluta-udbetalingslommebog på deres konto.
• Deres KYC-status er bekræftet.

Eksempel: aflæsning af akkumuleret overskud

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
}

Prisniveauer (live)

Hent værdierne direkte fra dette endpoint — indsæt aldrig disse værdier direkte i koden, da de kan ændres fra vores side. Lav i stedet en prisvælger til dine egne brugere i stedet for et felt til et frit beløb: hver pris, der vises, er allerede det nøjagtige beløb, der skal sendes, når betalingen oprettes, og de tilgængelige fordele, der vises her, fortæller brugerne præcis, hvad de får for den pris, så de vælger en pris, de forstår, i stedet for at gætte på et tal.

Der er en begrænsning på antallet af anmodninger pr. nøgle pr. minut. Hvert godkendt svar indeholder header-felterne X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset; overskrides grænsen, returneres fejlkoden 429 Too Many Requests sammen med header-feltet Retry-After.

Valgfrit, pr. partner. Indtil du tilføjer en post, accepterer dine nøgler anmodninger fra enhver IP-adresse — den første post ændrer alle denne partners nøgler, så de kun accepterer anmodninger fra adresser på tilladelseslisten.

Hver webhook signeres med HMAC-SHA256 ved hjælp af en hemmelig nøgle, der udstedes én gang ved oprettelsen — kontroller signaturen, før du stoler på indholdet. Begivenhederne sendes kun til den partner, der ejer den pågældende annoncør.