Documentation destinée aux développeurs

Chaque requête est authentifiée à l'aide d'une clé secrète figurant dans l'en-tête « Authorization », selon le schéma « Bearer ».

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

Si vos clés API permettent de créer des comptes publicitaires pour vos propres utilisateurs (mode « Connect » — voir la section « Authentification » ci-dessus), vous percevez une part des sommes versées par ces annonceurs pour leurs publicités. La répartition indiquée ci-dessous est récupérée en temps réel à partir de ce même point de terminaison ; elle n'est jamais codée en dur et est totalement distincte de la commission de parrainage mentionnée plus bas sur cette page.

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

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

Comment ça marche ?

1. L'un de vos annonceurs en mode Connect paie pour une publicité via votre intégration.
2. L'annonce est examinée et validée, soit automatiquement, soit par notre équipe de modération.
3. Votre part est en attente d'un versement automatique sur votre portefeuille, selon le même principe que le programme de parrainage ci-dessous.

Conditions de paiement

• Un portefeuille de paiement en cryptomonnaie est configuré sur votre compte partenaire.
• Aucune vérification d’identité n’est requise de votre part : votre compte partenaire a déjà fait l’objet d’une vérification lors de sa création.

Exemple : lecture du nombre cumulé d'actions

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
}

Chaque compte publicitaire dispose d'un ensemble d'outils d'IA intégrés — un générateur de contenu et d'éléments visuels publicitaires, un assistant conversationnel, un conseiller en budget et un outil d'audit SEO externe — financés par des crédits IA, en plus du forfait annuel.

Exemple — générer du contenu publicitaire

La même catégorie et la même description d'activité alimentent également le générateur d'images ci-dessous.

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
}

Créer un visuel correspondant à cette même publicité :

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
}

Ajoutez un bloc publicitaire prêt à l'emploi sur votre site — sans aucune étape de création, ni iframe. Le script s'affiche directement dans la page au sein d'un Shadow DOM isolé ; ainsi, ses styles n'interfèrent jamais avec ceux de votre site, et inversement.

Ajoutez-le à votre page

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

Par défaut, cela affiche le classement public complet de la catégorie, c'est-à-dire tous les annonceurs de la plateforme, et pas seulement ceux que vous avez recrutés. Pour n'afficher que les publicités des annonceurs que vous avez créés via le mode Connect (ceux qui génèrent votre commission), ajoutez « data-partner » suivi de votre identifiant de partenaire (que vous trouverez sur la page « Développeurs » de votre tableau de bord) :

<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 vos annonceurs appartiennent à plusieurs catégories, supprimez complètement « data-category » : en utilisant uniquement « data-partner », le widget affiche toutes vos publicités, toutes catégories confondues, dans une seule grille, ce qui vous évite d'avoir à créer un bloc de widget par catégorie :

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

Vous souhaitez afficher un bloc de type « pied de page » en plus de celui intégré au contenu, chacun présentant des publicités différentes ? Ajoutez un deuxième bloc de widgets avec l'attribut data-layout="compact" (une seule publicité, pouvant être réduite en une petite bulle) et l'attribut data-offset défini sur le nombre de publicités déjà affichées par votre premier widget :

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

Attributs

Comment la commission de parrainage est-elle effectivement versée au partenaire ? Le pourcentage, le mode de versement et les conditions préalables.

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
}

Conditions de paiement

• Le montant total des gains à verser à l'annonceur atteint le seuil minimal de paiement.
• Un portefeuille de retrait de cryptomonnaies est configuré sur leur compte.
• Leur statut KYC a été vérifié.

Exemple : lecture des bénéfices cumulés

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
}

Niveaux tarifaires (en ligne)

Lisez les données en temps réel à partir de ce point de terminaison — ne codez jamais ces valeurs en dur, car elles peuvent changer de notre côté. Créez un sélecteur de forfait pour vos propres utilisateurs plutôt qu’un champ de montant libre : chaque prix affiché correspond déjà au montant exact à envoyer lors de la création du paiement, et les avantages débloqués indiqués ici expliquent clairement aux utilisateurs ce que ce prix leur apporte. Ils choisissent ainsi un prix qu’ils comprennent, plutôt que de deviner un chiffre.

Le nombre de requêtes est plafonné par clé et par minute. Chaque réponse authentifiée comporte les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset ; tout dépassement de la limite entraîne le retour du code d'erreur 429 « Too Many Requests » accompagné d'un en-tête Retry-After.

Facultatif, par partenaire. Tant que vous n’avez pas ajouté d’entrée, vos clés acceptent les requêtes provenant de n’importe quelle adresse IP ; la première entrée fait passer toutes les clés de ce partenaire en mode « liste blanche uniquement ».

Chaque webhook est signé à l'aide de l'algorithme HMAC-SHA256, avec une clé secrète générée une seule fois, au moment de sa création. Il convient de vérifier la signature avant de considérer la charge utile comme fiable. Les événements ne sont transmis qu'au partenaire auquel appartient l'annonceur concerné.