Documentation de l'API

Intégrez la puissante API de Laenad pour l'automatisation et les solutions personnalisées

Introduction

Bienvenue dans la documentation de l'API Laenad. Notre API REST vous permet d'accéder par programmation à vos données d'affiliation, de gérer les offres et d'intégrer des solutions personnalisées à votre plateforme.

URL de base : https://api.laenad.com/v1

Toutes les réponses de l'API sont renvoyées au format JSON. L'API utilise les codes de statut et les verbes HTTP standard.

Authentification

Toutes les requêtes API nécessitent une authentification par clé API. Incluez votre clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Vous pouvez générer des clés API depuis le tableau de bord de votre compte. Chaque clé dispose d'autorisations spécifiques et peut être révoquée à tout moment.

POST /auth/generate-key

Générer une nouvelle clé API pour votre compte

Limites de débit

Pour garantir un usage équitable, l'API applique les limites de débit suivantes :

  • Offre Standard : 1 000 requêtes par heure
  • Offre Premium : 5 000 requêtes par heure
  • Offre Entreprise : requêtes illimitées

Les en-têtes de limite de débit sont inclus dans chaque réponse API :

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1640995200

Offres

Récupérez et filtrez les offres disponibles sur la plateforme.

GET /offers

Obtenir toutes les offres disponibles pour votre compte

Paramètres

Paramètre Type Obligatoire Description
page integer Facultatif Numéro de page pour la pagination (par défaut : 1)
limit integer Facultatif Éléments par page (par défaut : 20, max : 100)
category string Facultatif Filtrer par catégorie d'offre
country string Facultatif Filtrer par code pays (ISO 3166-1 alpha-2)
Exemple de réponse :
{
  "success": true,
  "data": [
    {
      "id": 12345,
      "name": "Premium VPN Offer",
      "category": "Software",
      "payout": 15.50,
      "currency": "USD",
      "countries": ["US", "CA", "GB", "AU"],
      "platform": "Android",
      "tracking_link": "https://track.laenad.com/?o=12345&a={affiliate_id}",
      "status": "active"
    }
  ],
  "pagination": {
    "total": 245,
    "page": 1,
    "pages": 13
  }
}
GET /offers/{id}

Obtenir des informations détaillées sur une offre spécifique

Rapports

Accédez à des données de reporting complètes sur votre performance d'affiliation.

GET /reports/statistics

Obtenir un résumé statistique pour une période donnée

Paramètres

Paramètre Type Obligatoire Description
start_date string Obligatoire Date de début (format AAAA-MM-JJ)
end_date string Obligatoire Date de fin (format AAAA-MM-JJ)
offer_id integer Facultatif Filtrer par identifiant d'offre spécifique
breakdown string Facultatif Répartition par : jour, offre, pays, appareil
Exemple de réponse :
{
  "success": true,
  "data": {
    "clicks": 15420,
    "conversions": 423,
    "revenue": 6565.50,
    "currency": "USD",
    "epc": 0.43,
    "conversion_rate": 2.74,
    "daily_breakdown": [
      {
        "date": "2026-03-27",
        "clicks": 2105,
        "conversions": 58,
        "revenue": 899.00
      }
    ]
  }
}

Conversions

Récupérez les données de conversions avec tous les détails.

GET /conversions

Obtenir la liste des conversions avec filtres

Paramètres

Paramètre Type Obligatoire Description
start_date string Obligatoire Date de début (AAAA-MM-JJ)
end_date string Obligatoire Date de fin (AAAA-MM-JJ)
status string Facultatif Filtrer par statut : en attente, approuvée, rejetée
offer_id integer Facultatif Filtrer par identifiant d'offre
Exemple de réponse :
{
  "success": true,
  "data": [
    {
      "id": 987654,
      "offer_id": 12345,
      "offer_name": "Premium VPN Offer",
      "conversion_time": "2026-03-27 14:32:15",
      "payout": 15.50,
      "currency": "USD",
      "status": "approved",
      "country": "US",
      "device": "mobile",
      "ip": "192.168.1.1"
    }
  ],
  "pagination": {
    "total": 423,
    "page": 1,
    "pages": 22
  }
}

Postbacks

Configurez et gérez les URL de postback pour les notifications de conversion en temps réel.

POST /postbacks/create

Créer une nouvelle URL de postback

Corps de la requête

Paramètre Type Obligatoire Description
url string Obligatoire Point de terminaison de votre URL de postback
event_type string Obligatoire Type d'événement : conversion, clic, lead
offer_id integer Facultatif Limiter à un identifiant d'offre spécifique
secret string Facultatif Clé secrète pour la validation

Paramètres de postback disponibles

Votre URL de postback peut inclure les paramètres suivants :

Paramètre Description
{conversion_id} Identifiant unique de conversion
{offer_id} Identifiant de l'offre
{payout} Montant du paiement de la conversion
{currency} Devise du paiement
{country} Code pays de l'utilisateur
{ip} Adresse IP de l'utilisateur
{status} Statut de la conversion
{datetime} Horodatage de la conversion
{external_id} Votre identifiant de transaction externe

Exemple d'URL de postback :

https://yoursite.com/postback?
conversion_id={conversion_id}&
offer_id={offer_id}&
payout={payout}&
country={country}&
status={status}&
datetime={datetime}

Aide et assistance

Si vous avez besoin d'aide pour intégrer l'API ou rencontrez des problèmes, notre équipe d'assistance est là pour vous aider.

Canaux d'assistance

  • E-mail : api@laenad.com
  • QQ: 8422800
  • WeChat: laenad
  • Telegram: @laenadcom

Ressources

SDK et bibliothèques

Des SDK officiels sont disponibles pour les langages de programmation populaires :

  • Python SDK
  • PHP SDK
  • JavaScript/Node.js SDK
  • Java SDK