Choisir un préfixe pris en charge
Utilisez un préfixe mobile individuel actuel issu de la découverte. Ce point de terminaison est destiné aux centraux NANPA : un NPA identifie l'indicatif régional, et un NXX identifie le central. Un préfixe composé uniquement de l'indicatif régional est trop large. N'envoyez pas d'identifiants d'affichage groupés et ne déduisez pas la prise en charge d'un autre pays sous prétexte que son préfixe contient suffisamment de chiffres.
Utiliser le décompte comme indication
Lisez response.count, avec response.npa et response.nxx identifiant le central. Il s'agit de l'instantané du service de couverture, et non d'un stock détenu pour votre compte. Confirmez les numéros réels, les devis applicables et toute exigence d'enregistrement avant de commander. Un décompte réussi n'autorise jamais un achat.
Distinguer un stock nul d'une recherche échouée
Un décompte réussi de zéro diffère d'une erreur d'API. Inspectez status.code et status.msg ainsi que le statut HTTP. Traitez un délai d'attente ou une recherche échouée comme une disponibilité inconnue et réessayez plus tard avec un délai entre les tentatives (backoff).
Requête
Utilisez les identifiants de votre compte API activé via HTTPS. L'authentification Basic et les jetons bearer de compte API activé sont pris en charge ; des restrictions de compte s'appliquent.
GET avec l'identifiant de préfixe dans le chemin d'URL. Il n'y a aucun paramètre de requête ni de corps documenté.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nom | Type | Requis | Description |
|---|---|---|---|
prefix_id | string | Oui | Copiez l'identifiant de préfixe individuel depuis la réponse de découverte. Utilisez un préfixe mobile NANPA pris en charge contenant un indicatif régional (NPA) et un central (NXX), et non un identifiant d'indicatif seul ou de résumé groupé. Traitez l'identifiant comme opaque. |
Réponse
Vérifiez status.code dans le corps JSON ainsi que le statut HTTP. Une response réussie a status.code 200 et status.msg Results. response est un objet, et non une liste : count est un instantané d'inventaire sous forme d'entier ; npa et nxx sont des chaînes de trois caractères. status.results n'est pas présent pour cet objet associatif. Un décompte de 0 signifie que la recherche de couverture n'a trouvé aucun central correspondant ou a renvoyé un stock nul ; cela ne prouve pas que tous les fournisseurs ou d'autres routes de découverte ne disposent d'aucun numéro.
Forme de réponse illustrative ; il ne s'agit ni de données de compte réelles ni d'un devis actuel.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Erreurs
- 404 : Fournisseur désactivé : la couverture d'inventaire mobile est indisponible sur le service.
- 404 : Identifiant de préfixe invalide : obtenez un identifiant de préfixe individuel actuel depuis la découverte.
- 404 : Préfixe invalide : le préfixe stocké ne contient pas assez de chiffres pour une recherche NPA/NXX.
- 500 : Échec de la couverture d'inventaire : la recherche en amont n'a pas renvoyé de résultat de couverture réussi. Réessayez plus tard avec un délai entre les tentatives (backoff) ; un échec n'est pas un décompte de stock de zéro.
Disponibilité et effets secondaires
- L'opération vérifie l'inventaire et ne passe pas de commande, ne réserve pas de numéros et ne débite pas de montant d'achat.
- Le stock peut changer immédiatement. Le décompte de couverture n'est pas ajusté pour garantir une possibilité d'achat propre au compte ou la même longueur que la réponse de la prochaine recherche de numéros.
- Une recherche contacte le service de couverture et peut prendre du temps. Ne sondez pas de manière répétée chaque préfixe et ne traitez pas un délai d'attente ou une erreur comme un stock nul réussi.