Ontwikkelaar-dokumentasie

Elke versoek word geverifieer met 'n geheime sleutel in die Authorization-kop, deur die Bearer-skema te gebruik.

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

As jou API-sleutels advertensie-rekeninge vir jou eie gebruikers skep (Konneksie-modus — sien Outentikasie hierbo), verdien jy 'n deel van wat daardie adverteerders vir hul advertensies betaal. Die onderstaande verdeling word regstreeks vanaf dieselfde eindpunt gelees, nooit hardgecodeer nie, en is heeltemal afsonderlik van die verwysingskommissie verder onderaan hierdie bladsy.

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

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

Hoe dit werk

1. Een van jou Connect-modus-adverteerders betaal vir 'n advertensie via jou integrasie.
2. Die advertensie word hersien en goedgekeur — outomaties, of deur ons modereringspan.
3. Jou aandeel is in die ry vir outomatiese uitbetaling na jou beursie, dieselfde meganisme as die verwysingsprogram hieronder.

Uitbetalingsvoorwaardes

• 'n kripto-uitbetalingsbeursie is op jou vennootrekening gekonfigureer.
• Geen KYC word aan jou kant vereis nie — jou vennootrekening is reeds by die skepping geverifieer.

Voorbeeld: lees opgehoopte aandele

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
}

Elke adverteerderrekening kry 'n stel ingeboude KI-gereedskap — 'n advertensie-inhoud- en visuele generator, 'n gesprekassistent, 'n begrotingsadviseur en 'n eksterne SEO-ouditeur — wat betaal word met KI-krediete bo-op die vaste jaarlikse prys.

Voorbeeld — genereer advertensie-inhoud

Dieselfde kategorie en beskrywing van die besigheid dryf ook die beeldgenerator hieronder aan.

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
}

Génereer 'n ooreenstemmende visuele vir dieselfde advertensie:

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
}

Laat 'n kant-en-klare advertensie-eenheid op jou eie webwerf val — geen opboustap, geen iframe nie. Die skrip render direk in die bladsy binne 'n geïsoleerde Shadow DOM, sodat die style daarvan nooit na jou webwerf lek nie, en die style van jou webwerf nooit daarin lek nie.

Voeg dit by jou bladsy

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

Standaard wys dit die volledige openbare ranglys vir die kategorie — elke adverteerder op die platform, nie net dié wat jy ingebring het nie. Om slegs die advertensies van adverteerders wat jy via Connect-modus geskep het (dié wat jou aandeel genereer) te wys, voeg data-partner saam met jou vennoot-ID by (vind dit op die Ontwikkelaarsbladsy van jou eie 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>

As jou adverteerders oor verskeie kategorieë strek, laat data-category heeltemal weg — met slegs data-partner wys die widget al jou advertensies oor alle kategorieë in een rooster, in plaas daarvan om per kategorie 'n widgetblok te benodig:

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

Wil jy 'n voetskrif-styl-eenheid langs jou in-inhoud-eenheid hê, elk met verskillende advertensies? Voeg 'n tweede widgetblok by met data-layout="compact" ('n enkele advertensie, in 'n klein pil ineenklapbaar) en stel data-offset in op hoeveel advertensies jou eerste widget reeds wys:

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

Eienskappe

Hoe 'n vennoot se verwysingskommissie eintlik by hulle uitkom — die persentasie, die uitbetalingsmeganisme en die voorwaardes.

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
}

Uitbetalingsvoorwaardes

• Die adverteerder se totale betaalbare verdienste bereik die minimum uitbetalingsbedrag.
• 'n kripto-uitbetalingsbeursie is op hul rekening gekonfigureer.
• Hul KYC-status is geverifieer.

Voorbeeld: lees opgehoopte verdienste

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
}

Prysklasse (lewendig)

Lees regstreeks vanaf hierdie eindpunt — moenie hierdie waardes ooit hardkodeer nie, hulle kan aan ons kant verander. Bou 'n vlakkiezer vir jou eie gebruikers in plaas van 'n vrye bedragveld: elke prys wat gewys word, is reeds die presiese bedrag wat gestuur moet word wanneer die betaling geskep word, en die ontslote voordele wat hier gewys word, vertel gebruikers presies wat daardie prys vir hulle inhou, sodat hulle 'n prys kies wat hulle verstaan in plaas daarvan om 'n nommer te raai.

Versoeke is per sleutel per minuut beperk. Elke geverifieerde antwoord dra die X-RateLimit-Limit-, X-RateLimit-Remaining- en X-RateLimit-Reset-kopvelde; as die limiet oorskry word, word 429 Te Baie Versoeke teruggestuur met 'n Retry-After-kopveld.

Opsioneel, per vennoot. Totdat jy 'n inskrywing byvoeg, aanvaar jou sleutels versoeke van enige IP-adres — die eerste inskrywing skakel al die sleutels van daardie vennoot oor na slegs toegelate adresse.

Elke webhook word met HMAC-SHA256 onderteken deur gebruik te maak van 'n geheime sleutel wat eenmalig by die skepping uitgereik is — verifieer die handtekening voordat jy die lading vertrou. Gebeure word slegs aan die vennoot gelewer wat die betrokke adverteerder besit.