Documentation de l'API

Une API REST unique pour valider vos données. Créez un compte (100 crédits offerts), générez une clé dans votre espace, puis appelez l'endpoint ci-dessous.

Authentification

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

Authorization: Bearer dck_live_votre_cle

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 (par défaut FR)
}

Chaque appel réussi consomme 1 crédit. Réponse 402 si le solde est épuisé.

Exemple (JavaScript)

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

Réponses par type

{
  "type": "email",
  "input": "contact@exemple.fr",
  "valid": true,
  "syntaxValid": true,
  "domain": "exemple.fr",
  "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",
  "reason": null,
  "credits_remaining": 97
}

{
  "type": "iban",
  "input": "FR7630006000011234567890189",
  "valid": true,
  "country": "FR",
  "formatOk": true,
  "lengthOk": true,
  "bankCode": "30006",
  "credits_remaining": 96
}

Sur le type siret, l'API contrôle la clé de Luhn (et la règle dérogatoire des SIRET La Poste en 356000000). Pour voir ce calcul déroulé chiffre par chiffre, le découpage SIREN + NIC et la dérivation du n° de TVA intracommunautaire, utilisez le décodeur SIRET — il tourne dans le navigateur, sans clé ni crédit.

Codes d'erreur