Adlead - Documentation

# Préambule

Les kits d'intégration regroupent des exemples concrets pour connecter votre environnement technique à l'API Adlead.
Chaque kit illustre un cas d'usage précis, avec du code prêt à l'emploi, afin de réduire le temps d'implémentation et sécuriser vos échanges avec l'API.

Ces kits sont conçus comme un accélérateur : ils offrent une base pour démarrer rapidement vos intégrations, sans couvrir l'ensemble des cas d'usage possibles ni les spécificités propres à votre environnement.

# À qui s'adressent ces kits ?

Ces kits proposent des exemples simplifiés pour faciliter la prise en main de l'API Adlead.
Ils fournissent un code simple conçu comme un point de départ pour réaliser une intégration rapidement.

Ces ressources sont particulièrement utiles si vous découvrez l'intégration d'API ou si vous souhaitez un guide pratique immédiat.
En revanche, elles ne couvrent pas les cas avancés : les développeurs déjà expérimentés avec les API trouveront plus de détails et de flexibilité dans la documentation API.

# Objectif

  • Offrir un point de départ clair et fonctionnel
  • Réduire le temps de mise en place d'une intégration
  • Illustrer que les intégrations de base peuvent être réalisées de manière simple et rapide

# Cas d'usage disponibles

  • Transmission des leads → Exemple d'implémentation permettant d'envoyer un lead généré sur l'un de vos sites ou formulaires.

# Prérequis

  • Une clé API fournie par Adlead avec les bonnes permissions et l'accès aux bons programmes
  • Un environnement technique capable d'effectuer des requêtes HTTP / appels API

# Étapes pour démarrer

  1. Choisissez le cas d'usage correspondant à votre besoin
  2. Inspirez-vous de l'exemple fourni
  3. Remplacez la clé API et mappez vos champs avec ceux de votre projet
  4. Testez et vérifiez la bonne réception des données dans Adlead

# Bonnes pratiques

  • Transmettre les données en JSON UTF-8
  • Authentifier vos requêtes via le header : X-API-Key: {VOTRE_CLE_API}
  • Vérifier les codes retour HTTP :
    • 2xx → Succès, action réalisée
    • 4xx → Erreur de validation ou autorisation
    • 5xx → Erreur serveur

Transmission des leads →