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

Email type: "email"

Syntaxe RFC, domaine, MX, détection jetable et adresses génériques.

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

Téléphone type: "phone"

Validité et format international (E.164), type de ligne, indicatif pays.

{
  "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
}

SIRET / SIREN type: "siret"

Contrôle de la clé de Luhn et du format (9 ou 14 chiffres).

{
  "type": "siret",
  "input": "55210055400021",
  "valid": true,
  "kind": "SIRET",
  "siren": "552100554",
  "reason": null,
  "credits_remaining": 97
}

IBAN type: "iban"

Contrôle mod-97 ISO 13616, longueur par pays et format BBAN.

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

Codes d'erreur

Code	Signification
401	Clé API manquante ou invalide
402	Crédits insuffisants
400	Requête invalide (type/valeur)

Prêt à intégrer Data Checker ?

Obtenir ma clé API gratuite