Codes de statut

L’API Enrow utilise des codes de statut HTTP standard pour indiquer le résultat de chaque requête, ainsi qu’un champ qualification qui vous renseigne sur le résultat d’une recherche ou d’une vérification. Cette page répertorie tous les codes et toutes les valeurs de qualification afin que vous puissiez gérer les réponses de manière fiable. Pour les messages d’erreur correspondants et les formats de réponse, consultez Gestion des erreurs.

​

Quels codes de statut HTTP l’API renvoie-t-elle ?

L’API Enrow utilise des codes de statut HTTP standard pour indiquer le résultat de chaque requête. Un code 2xx signifie que la requête a réussi, un code 4xx indique un problème avec la requête, et un code 5xx signifie qu’un problème est survenu du côté d’Enrow.

​

Quels codes signifient un succès ?

Un code de statut 2xx signifie que l’API a accepté la requête. Les opérations asynchrones (telles que les recherches groupées) renvoient 201 ou 202 car le traitement se poursuit en arrière-plan.

​

Quels codes signifient que la requête a été rejetée ?

Un code de statut 4xx signifie que l’API a rejeté la requête en raison d’un problème corrigeable côté client : paramètres invalides, clé API manquante ou invalide, crédits insuffisants ou trop de requêtes. Un 401 signifie que la clé API est manquante ou invalide : consultez Authentification pour savoir comment la transmettre correctement. Un 402 signifie que le compte n’a plus de crédits ; vérifiez la consommation dans Crédits et facturation. Un 429 signifie que la requête a dépassé le débit autorisé : consultez Limites de débit pour comprendre les seuils.

​

Quels codes signifient une erreur serveur ?

Un code de statut 5xx signifie que la requête était valide mais qu’un problème est survenu du côté d’Enrow. Ces réponses peuvent être réessayées sans risque après un court délai.

​

Que sont les qualifications de recherche ?

Une qualification de recherche est la valeur du champ qualification qui vous indique le résultat d’une recherche ou d’une vérification. Enrow renvoie ce champ sur tous les endpoints, et le résultat est toujours binaire : il n’y a pas de « peut-être » ni de score de probabilité. C’est un choix de conception délibéré.

​

Pourquoi le résultat est-il binaire ?

Le résultat est binaire car une réponse claire par oui ou par non est plus simple à exploiter qu’une probabilité. La plupart des outils d’enrichissement renvoient un ensemble complexe de catégories (catch-all, à risque, inconnu, invérifiable, etc.) qui vous obligent à construire une logique autour de probabilités. Enrow a adopté l’approche inverse :

• Enrow vérifie même les e-mails catch-all de manière déterministe, ce qui rend inutile toute catégorie « catch-all »
• Enrow ne croit pas aux systèmes probabilistes comportant des dizaines de classifications : ils ajoutent de la complexité sans apporter de clarté
• Un résultat binaire signifie que vous pouvez exploiter les données immédiatement, sans avoir à les remettre en question

Le résultat est bon ou il ne l’est pas. Simple.

​

Quelles qualifications l’Email Finder renvoie-t-il ?

L’Email Finder renvoie l’une des valeurs suivantes dans le champ qualification :

​

Quelles qualifications l’Email Verifier renvoie-t-il ?

L’Email Verifier renvoie l’une des valeurs suivantes dans le champ qualification :

​

Quelles qualifications le Phone Finder renvoie-t-il ?

Le Phone Finder renvoie l’une des valeurs suivantes dans le champ qualification :

​

Comment suivre une recherche groupée ?

Pour les opérations groupées, un champ status indique l’avancement du lot. Interrogez l’endpoint GET concerné — résultats groupés de l’Email Finder, vérifications groupées de l’Email Verifier ou résultats groupés du Phone Finder — jusqu’à ce que le status soit completed.

​

FAQ

​

Étapes suivantes