Sommaire

  1. Vue d'ensemble
  2. Changements d'authentification
  3. Changements d'endpoint
  4. Correspondance des champs
  5. Exemples de requêtes
  6. Format de réponse
  7. Gestion des erreurs
  8. Envoi de fichiers
  9. Mode test
  10. FAQ / Points d'attention

1. Vue d'ensemble

L'API Oplead (https://api.oplead.com) remplace l'API dépréciée “API Import” (https://leadimport.oplead.com/addlead/). Les principaux changements sont :

Aspect Import dépréciée Oplead.API
Authentification Token dans le body (token) Clé API dans le header X-Api-Key
Format d'entrée JSON plat (flat) ou XML ou form-urlencoded JSON structuré uniquement
Format de sortie JSON ou XML (selon format) JSON uniquement
Endpoint POST /addlead POST /v1/leads
Références aux entités Codes et noms passés en valeur simple (string) Objets { "code": "..." } ou { "name": "..." }

2. Changements d'authentification

Avant (API Import dépréciée)

L'authentification se faisait via un token chiffré (ENT_ID encrypté) envoyé directement dans le body de la requête :

{
  "token": "u3xs03L8wkc=",
  "form": "FormContact",
  "ctc_lastname": "Dupont",
  ...
}