Vérifier la couverture de la table des attributions
Vérifiez si un numéro nord-américain correspond à un préfixe de la table des attributions de MultiTEL et obtenez la ville, l’État et le pays associés. Il s’agit d’une recherche dans une table de préfixes. Elle ne permet pas d’établir qu’un abonné est actif, qu’un numéro est attribué, qu’il appartient à votre compte ou que vous pouvez le commander.
Requête
Utilisez votre compte API activé et une adresse IP source autorisée. L’exemple utilise des identifiants d’authentification HTTP Basic provenant de variables d’environnement et un numéro fictif. Aucun corps de requête n’est requis.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Privilégiez un numéro nord-américain à onze chiffres commençant par 1. Le gestionnaire supprime les caractères autres que les chiffres et ajoute 1 au début d’une saisie à dix chiffres. Tout autre nombre de chiffres est rejeté. Cette normalisation ne vérifie pas toutes les règles de numérotation nord-américaines ; une correspondance trouvée dans la table ne constitue donc pas une validation exhaustive du numéro.
Réponse
Les valeurs des champs sont fournies uniquement à titre d’illustration ; il ne s’agit pas d’un résultat obtenu à partir de la table des attributions en service.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Champ | Signification |
|---|---|
| number | Saisie normalisée composée uniquement de chiffres. |
| npanxx | Le préfixe enregistré correspondant. Le gestionnaire privilégie un préfixe à sept chiffres composé des indicatifs de pays, de zone et de central téléphonique, et peut se rabattre sur un préfixe à quatre chiffres composé des indicatifs de pays et de zone ; ne supposez pas que ce champ identifie toujours un indicatif de central complet. |
| city, state, country | Métadonnées du préfixe d’attribution correspondant. Ces champs n’indiquent ni la localisation physique actuelle d’un abonné ni son opérateur actuel après un portage du numéro. |
Erreurs
Consultez, dans le JSON, le champ status.code plutôt que de vous fier uniquement au code HTTP 200. Le code API 404 accompagné du message Not part of NANPA signifie qu’aucun préfixe ne correspond dans la table utilisée par le service ; il ne constitue pas une décision définitive d’une autorité de numérotation à l’échelle mondiale. Le code API 500 est utilisé lorsque le nombre de chiffres est invalide ou que le numéro est manquant.
Coût et étapes suivantes
Le gestionnaire examiné interroge une table locale des attributions et ne comporte ni débit du compte ni recherche externe. Ce gestionnaire n’applique aucuns frais de recherche. Utilisez la recherche de numéros disponibles pour trouver des numéros en stock pouvant être commandés. Une recherche de nom, une recherche de routage ou une commande de numéro constitue une opération distincte, soumise à sa propre tarification sur le compte.