Articles d'aideRéférence API
Commencez ici
CommencerFAQPlans et tarifs
Tarification & plansAnnonceurs
Exécution de campagnesÉditeurs
Ajouter un site et un tag publicitaireArgent
Dépôts et paiementsCompte
Sécurité du compteDéveloppeurs
Référence APILégal
Conditions d'utilisationPolitique de confidentialitéL’API REST d’Adgora permet de consulter les statistiques, de lister et suspendre les campagnes, de vérifier les soldes et de lister les zones par programmation. URL de base: https://api.adgora.net. Toutes les réponses sont au format JSON.
Authentification
Créez une paire de clés dans votre profil (la clé secrète est affichée une seule fois). Transmettez-la dans chaque /v1 requête:
Authorization: Bearer {public_key}:{secret}Les requêtes sont limitées à 120 par minute et par compte; au-delà de la limite, la réponse est 429 avec un Retry-After en-tête. Les clés disposent de périmètres d’autorisation (stats, campaigns, balance, zones); si un périmètre requis manque, la réponse est 403.
Points de terminaison
| Méthode & chemin | Périmètre | Réponse |
|---|---|---|
GET /v1/balance | balance | soldes en USD des annonceurs & éditeurs |
GET /v1/stats?days=7 | stats | données quotidiennes (ajoutez role=publisher pour la vue éditeur) |
GET /v1/campaigns | campaigns | vos campagnes |
POST /v1/campaigns/{id}/pause | campaigns | suspend une campagne |
POST /v1/campaigns/{id}/resume | campaigns | reprend une campagne |
GET /v1/zones | zones | vos zones éditeur |
Exemple
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"Postback S2S des conversions
Pour suivre les conversions CPA, appelez l’URL de postback depuis le serveur de l’annonceur lorsqu’une conversion se produit. La {clickid} macro est transmise à votre page de destination via l’URL du clic — récupérez-la et renvoyez-la:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status peut être confirmed, delivered, rejected ou returned; order_ref est votre identifiant de commande facultatif. Retrouvez la clé secrète de l’offre sur la page de l’offre.
Macros de l’URL de destination
Ajoutez ces macros à l’URL de destination d’une création — Adgora les remplace au moment du clic:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Construire une demande
Choisissez un point de terminaison et des paramètres — la commande se met à jour au fur et à mesure. Les clés restent des espaces réservés : ne collez jamais un secret dans une page web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET est un espace réservé. Créez une clé dans votre profil et gardez le secret sur votre serveur.
