POST AI agent ready /v1/phone

API de validation de téléphone - Analyseur de numéros gratuit

Analyse et valide un numéro de téléphone. Renvoie les versions formatées (E.164, national), le code du pays et le nom du pays.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/phone \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","country":"US"}'

When to use this API

Normaliser les numéros de téléphone dans une base de données de contacts

Les utilisateurs saisissent leurs numéros de téléphone dans des dizaines de formats : « 415-555-2671 », « (415) 555 2671 », « +1 415.555.2671 ». Analysez chacun via ce point de terminaison pour obtenir le format E.164 standardisé pour le stockage. Utilisez le format_national pour l'affichage dans l'interface utilisateur.

Acheminer les messages SMS par pays

Avant d'envoyer un SMS via votre fournisseur de messagerie, validez le numéro de téléphone et extrayez son indicatif pays. Acheminez les messages via des passerelles SMS spécifiques à la région pour réduire les coûts et améliorer les taux de livraison.

Bloquer les numéros invalides dans les formulaires d'inscription

Validez les numéros de téléphone lors de la soumission du formulaire d’inscription. Rejetez immédiatement les numéros invalides et montrez aux utilisateurs le format national comme confirmation de ce qui a été analysé, en détectant les fautes de frappe avant qu'elles n'atteignent votre base de données.

Frequently asked questions

Quels formats de numéros de téléphone sont acceptés ?

Le point de terminaison accepte le format international (+14155552671), le format national ((415) 555-2671) et les variantes les plus courantes avec des tirets, des points ou des espaces. L'inclusion du préfixe de l'indicatif du pays donne les résultats les plus précis.

Quand dois-je utiliser le paramètre country ?

Utilisez le paramètre country lorsque le numéro de téléphone n'inclut pas de préfixe d'indicatif de pays (par exemple "4155552671" sans "+1"). L'indicateur de pays indique à l'analyseur quel plan de numérotation appliquer.

Qu'est-ce que le format E.164 ?

E.164 est la norme internationale pour les numéros de téléphone. Il commence par un "+" suivi de l'indicatif du pays et du numéro d'abonné, sans espaces ni ponctuation. Exemple : +14155552671.

Cela vérifie-t-il que le numéro de téléphone est en service ?

Non. Ce point de terminaison valide uniquement le format et la structure. Il n’appelle pas et n’envoie pas de SMS au numéro pour vérifier qu’il est actif.

Puis-je valider les numéros de téléphone fixe et mobile ?

Oui. L'analyseur gère à la fois les formats de numéros fixes et mobiles. Il valide en fonction des règles du plan de numérotation du pays.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.