Documentation de l'API

Authentification

Toutes les requêtes portent votre clé API dans l'en-tête HTTP :

Authorization: Bearer dck_live_…

Endpoint

POST https://data-checker.fr/api/v1/validate

Corps de la requête (JSON) :

{
  "type": "email | phone | siret | iban",
  "value": "la valeur à vérifier",
  "country": "FR"   // optionnel, pour le téléphone
}

Chaque appel réussi consomme 1 crédit. La réponse est un 402 quand le solde est épuisé, un 401 quand la clé manque ou n'est pas reconnue.

Exemple (JavaScript)

const res = await fetch("https://data-checker.fr/api/v1/validate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer dck_live_…",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ type: "email", value: "contact@example.com" }),
});
const data = await res.json();
console.log(data.valid); // true | false

Réponses par type

{
  "type": "email",
  "input": "contact@example.com",
  "valid": true,
  "syntaxValid": true,
  "domain": "example.com",
  "mxFound": true,
  "disposable": false,
  "roleBased": true,
  "reason": null,
  "credits_remaining": 99
}

{
  "type": "phone",
  "input": "06 12 34 56 78",
  "valid": true,
  "e164": "+33612345678",
  "national": "06 12 34 56 78",
  "international": "+33 6 12 34 56 78",
  "country": "FR",
  "type_line": "mobile",
  "credits_remaining": 98
}

{
  "type": "siret",
  "input": "55210055400021",
  "valid": true,
  "kind": "SIRET",
  "siren": "552100554",
  "nic": "00021",
  "formatted": "552 100 554 00021",
  "laPoste": false,
  "vatNumber": "FR96552100554",
  "vatKey": "96",
  "reason": null,
  "credits_remaining": 97
}

{
  "type": "iban",
  "input": "FR1420041010050500013M02606",
  "valid": true,
  "country": "FR",
  "countryName": "France",
  "sepa": true,
  "formatOk": true,
  "lengthOk": true,
  "formatted": "FR14 2004 1010 0505 0001 3M02 606",
  "bankCode": "20041",
  "bank": "La Banque Postale",
  "bic": "PSSTFRPP",
  "bban": { "banque": "20041", "guichet": "01005", "compte": "0500013M026" },
  "ribKeyValid": true,
  "credits_remaining": 96
}

Sur le type siret, l'API contrôle la clé de Luhn — y compris la règle dérogatoire des SIRET La Poste en 356000000 —, renvoie le découpage siren + nic et dérive le numéro de TVA intracommunautaire. Ces champs sont calculés à partir du numéro : l'API ne vérifie pas l'existence de l'entreprise auprès de l'INSEE. Pour voir le calcul déroulé chiffre par chiffre, utilisez le décodeur SIRET — il tourne dans le navigateur, sans clé ni crédit.

Sur le type iban, la réponse ajoute le pays, l'appartenance à la zone SEPA, l'IBAN mis en forme et, pour un IBAN français, le découpage du BBAN, le contrôle de la clé RIB nationale et le nom de banque quand le code établissement est reconnu.

Codes d'erreur