Rechercher des informations de routage

Demandez des informations de routage pour un numéro de téléphone nord-américain. Utilisez-les pour interpréter les données disponibles sur le routage et l’opérateur, et non comme preuve de l’identité de l’abonné, de la propriété du numéro, de la possibilité de le joindre ou de sa disponibilité à l’achat. Une recherche peut entraîner un débit sur votre compte.

Requête

Utilisez votre compte API activé et l’adresse IP source autorisée pour ce compte. Fournissez le numéro complet sous forme de chiffres, en incluant l’indicatif de pays 1. L’exemple utilise des variables d’environnement et un numéro fictif. Le gestionnaire ne normalise pas la ponctuation ; validez la saisie avant de l’envoyer.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

Réponse

Seuls certains champs sont présentés à titre d’exemple ; leur disponibilité dépend de la source et du type de numéro.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

La recherche standard convertit en minuscules les noms des champs renvoyés. Selon la source, des champs relatifs à l’opérateur, au centre tarifaire, à la localisation et à la juridiction peuvent être présents. La réponse ne constitue pas une fiche d’abonné complète à structure fixe. L’indicateur local peut être le nombre 1 ou la chaîne de caractères 0. Le gestionnaire calcule ported en comparant le numéro de routage renvoyé au numéro de téléphone fourni ; ne l’interprétez pas comme un historique complet et vérifié des portages.

Tarification et nouvelles tentatives

Le gestionnaire examiné débite le compte de $0.00025 lorsqu’il atteint son étape de finalisation et enregistre la recherche. Le coût renvoyé est normalement une chaîne de caractères incluant le symbole du dollar, plutôt qu’un simple montant numérique. Aucune clé d’idempotence n’est proposée. Répéter une requête peut entraîner des frais supplémentaires.

Pour les comptes prépayés, le code vérifie que le solde est d’au moins 0.00025. Son message de solde insuffisant mentionne actuellement $5, ce qui ne correspond pas à ce seuil. Interprétez cet échec comme un rejet lié au solde et vérifiez les fonds du compte avant de réessayer.

Échecs et réussites incomplètes

Consultez à la fois le statut HTTP et les champs status.code/status.msg du contenu JSON. Un résultat vide pour une recherche standard renvoie le code API 404. Le code API 403 peut indiquer un solde prépayé insuffisant.

Un scénario d’erreur actuel concernant les numéros gratuits peut tout de même débiter le montant de la recherche et renvoyer le code API 200 sans champs de routage utiles ; le coût indiqué peut être incomplet. Un code 200 ne suffit donc pas, à lui seul, à établir que la recherche est exploitable. Validez les champs nécessaires à votre application, rapprochez les frais incertains des relevés de facturation du compte et contactez l’assistance en cas de résultats incomplets.

Dans l’implémentation examinée, le traitement des numéros gratuits varie selon la longueur de la saisie. Privilégiez le numéro international complet sous forme de chiffres et confirmez auprès de l’assistance la couverture nécessaire pour les numéros gratuits. Ne relancez pas automatiquement une recherche dont le résultat est mal formé ou incomplet, et ne vous fiez pas à une recherche de routage pour décider qu’un numéro peut être appelé sans risque ou que vous êtes autorisé à l’appeler.