Documentació per a desenvolupadors

Cada sol·licitud s'autentica amb una clau secreta a l'encapçalament Authorization, utilitzant l'esquema Bearer.

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

Si les teves claus d'API creen comptes d'anunciants per als teus propis usuaris (mode Connect — vegeu Autenticació més amunt), obtens una part del que aquests anunciants paguen pels seus anuncis. La distribució que es mostra a continuació es llegeix en directe des d'aquest mateix punt final, mai no està codificada de manera estàtica i és totalment independent de la comissió de referència que es troba més avall en aquesta pàgina.

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

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

Com funciona

1. Un dels vostres anunciants en mode Connect paga un anunci a través de la vostra integració.
2. L'anunci es revisa i s'aprova — automàticament o pel nostre equip de moderació.
3. La teva part està a la cua per al pagament automàtic al teu moneder, el mateix mecanisme que el programa de referència següent.

Condicions de pagament

• S'ha configurat una cartera de pagament de criptomonedes al vostre compte de soci.
• No cal cap KYC per part teva — el teu compte de soci ja ha estat verificat en crear-se.

Exemple: llegir les accions acumulades

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
}

Cada compte d'anunciant disposa d'un conjunt d'eines d'IA integrades — un generador de contingut i imatges per a anuncis, un assistent conversacional, un assessor de pressupostos i un auditor SEO extern — pagades amb crèdits d'IA, a més del preu anual fix.

Exemple — generar contingut d'anunci

La mateixa categoria i la descripció del negoci també alimenten el generador d'imatges següent.

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
}

Genera una imatge visualitzadora per al mateix anunci:

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
}

Arrossega una unitat publicitària ja preparada al teu propi lloc web — sense cap pas de configuració ni iframe. L'script renderitza directament a la pàgina dins d'un Shadow DOM aïllat, de manera que els seus estils mai no es filtren al teu lloc web, i els estils del teu lloc web mai no es filtren en ell.

Afegeix-ho a la teva pàgina

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

Per defecte, això mostra la classificació pública completa de la categoria — tots els anunciants de la plataforma, no només els que has incorporat. Per mostrar només els anuncis dels anunciants que has creat mitjançant el mode Connect (els que generen la teva quota), afegeix data-partner amb el teu ID de soci (troba'l a la pàgina de desenvolupadors del teu propi tauler de control):

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

Si els teus anunciants abasten diverses categories, elimina completament data-category — només amb data-partner, el widget mostra tots els teus anuncis de totes les categories en una única graella, en lloc de necessitar un bloc de widget per categoria:

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

Vols una unitat d'estil de peu de pàgina al costat de la que tens dins del contingut, cadascuna mostrant anuncis diferents? Afegeix un segon bloc de widgets amb data-layout="compact" (un sol anunci, plegable en una petita píndola) i data-offset establert al nombre d'anuncis que el teu primer widget ja mostra:

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

Atributs

Com arriba realment a un soci la comissió de referència — el percentatge, el mecanisme de pagament i les precondicions.

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
}

Condicions de pagament

• Els guanys totals pagables de l'anunciant arriben a l'import mínim de pagament.
• S'ha configurat una cartera de pagament de criptomonedes al seu compte.
• El seu estat KYC està verificat.

Exemple: llegir els guanys acumulats

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
}

Nivells de preus (en directe)

Llegiu en directe des d'aquest punt final — no configureu mai aquests valors de manera estàtica, poden canviar del nostre costat. Crea un selector de nivell per als teus propis usuaris en lloc d'un camp de quantitat lliure: cada preu que es mostra ja és la quantitat exacta a enviar en crear el pagament, i els beneficis desbloquejats que es mostren aquí indiquen als usuaris exactament què els ofereix cada preu, de manera que poden triar un preu que entenguin en lloc d'endevinar una xifra.

Les sol·licituds estan limitades per clau i per minut. Cada resposta autenticada inclou els encapçalaments X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset; superar el límit retorna 429 Too Many Requests amb un encapçalament Retry-After.

Opcional, per a cada soci. Fins que no afegeixis una entrada, les teves claus accepten sol·licituds des de qualsevol IP — la primera entrada canvia totes les claus d'aquest soci perquè només admetin la llista blanca.

Cada webhook està signat amb HMAC-SHA256 mitjançant un secret emès un sol cop en el moment de la creació — verifiqueu la signatura abans de confiar en la càrrega útil. Els esdeveniments només es lliuren al soci que posseeix l'anunciant corresponent.