Lead Ingestion API

Automatisez la remontée de vos prospects vers le CRM France Papers avec notre Gateway haute disponibilité sécurisée par token.

Conformité RGPD

Toutes les requêtes HTTP doivent inclure une preuve de consentement du prospect (`rgpdConsent: true`). Les requêtes sans ce flag seront rejetées avec une erreur 400.

Authentification

Pour authentifier vos requêtes, vous devez passer votre clé API unique dans le header x-api-key.

# Header HTTP

x-api-key: sg_partner_votre_token_confidentiel

Remonter un Lead

POST/webhooks/lead-gateway/ingest

Paramètres du Body (JSON)

Champ	Type	Requis	Description
firstName	string	Oui	Prénom du prospect
lastName	string	Oui	Nom du prospect
phone	string	Oui	Mobile (Format international +33...)
rgpdConsent	boolean	Oui	Proof of consent. Must be true.
externalId	string	Non	Votre ID de transaction interne

Intégration Code

Node.jsPHP / CURLPython


// Exemple d'implémentation en Node.js (Fetch)
const sendLead = async () => {
  const URL = 'https://api.demarchesejour.fr/webhooks/lead-gateway/ingest';
  const API_KEY = 'votre_cle_api_ici';

  const payload = {
    firstName: 'Jean',
    lastName: 'Dupont',
    phone: '+33612345678',
    email: 'jean.dupont@email.com',
    rgpdConsent: true,
    externalId: 'votre_ref_interne_123'
  };

  const res = await fetch(URL, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': API_KEY
    },
    body: JSON.stringify(payload)
  });

  return await res.json();
};

Gestion des Erreurs

401 Unauthorized

La clé API est invalide, expirée ou désactivée.

200 Duplicate

Le lead a déjà été envoyé au cours des 30 derniers jours.