Rechercher le nom d’un appelant

Rechercher le nom d’un appelant

Obtenez le nom d’appelant disponible pour un numéro de téléphone. Cette recherche s’effectue en production et peut entraîner des frais sur votre compte, y compris lorsque le résultat provient du cache du service. Elle ne modifie pas le nom présenté lors des appels sortants pour un numéro qui vous appartient.

Le nom renvoyé ne constitue pas une vérification de l’identité ou de la propriété du numéro, ni une autorisation d’appeler. Le nom peut être absent, obsolète, abrégé, correspondre à une indication géographique ou être remplacé par un numéro de téléphone.

Requête

Utilisez votre compte API activé depuis l’adresse IP source autorisée pour ce compte. Conservez les identifiants dans un stockage de secrets côté serveur. L’exemple utilise des variables d’environnement et un numéro nord-américain fictif ; ne placez pas les identifiants dans des URL ni dans du code de navigateur accessible au public.

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

Fournissez le numéro complet sous forme de chiffres, indicatif de pays compris, par exemple onze chiffres commençant par 1 pour l’Amérique du Nord. Ne comptez pas sur le gestionnaire pour normaliser les signes de ponctuation ou le signe plus. Aucun corps de requête ni sélecteur de région n’est nécessaire. Confirmez auprès de MultiTEL la couverture prise en charge pour l’utilisation prévue.

Réponse

Valeurs fournies uniquement à titre d’exemple ; le coût ne constitue pas un devis.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Frais et rapprochement

Les résultats contenant un nom sont facturés au tarif CNAM configuré pour le compte. Une recherche répétée ou servie depuis le cache peut entraîner de nouveaux frais ; aucune clé d’idempotence n’est mise à disposition. Vérifiez le tarif actuel du compte avant d’activer les recherches automatisées.

La réponse présente une limitation connue lorsqu’un nom vide est en cache : le gestionnaire peut renvoyer le code API 200 avec un nom vide, un coût non nul et un solde calculé réduit, alors même que cette branche de traitement ne débite pas le compte. Ne considérez pas cette seule réponse comme la preuve d’une facturation. Effectuez un rapprochement avec les relevés de facturation du compte et une nouvelle consultation du solde, et contactez l’assistance en cas de résultats ambigus.

Le contrôle du crédit prépayé exige actuellement un solde d’au moins 0.004 avant la recherche, indépendamment du prix configuré par requête. Un compte dont les achats sont désactivés est également refusé. Ces contrôles ne font pas de ce point de terminaison une API de devis ou de plafonnement des dépenses.

Erreurs et nouvelles tentatives

Vérifiez à la fois le statut HTTP et les valeurs status.code/status.msg du contenu JSON. Le code API 403 peut indiquer un crédit prépayé insuffisant, des achats interdits, un problème d’autorisation du compte ou l’absence de nom d’appelant. Le parcours sans nom peut renvoyer le code sous forme de chaîne de caractères. Examinez le message plutôt que d’interpréter chaque code 403 comme des identifiants incorrects. Des conflits de configuration peuvent entraîner le renvoi du code API 500.

Un dépassement de délai peut survenir après une recherche facturable. Limitez le nombre de nouvelles tentatives et espacez-les progressivement, uniquement si cela convient à votre application, en effectuant d’abord un rapprochement pour les tentatives dont l’issue est incertaine. Ne relancez pas continuellement les tentatives pour un numéro refusé ou un échec lié aux autorisations ou au solde du compte. Un cache de réponses dans votre propre application peut réduire les requêtes répétées, sous réserve de votre accord contractuel et de vos exigences d’exactitude.

Autres opérations sur les numéros

Cette opération de lecture est distincte d’une mise à jour du nom présenté lors des appels sortants ou de LIDB, d’une inscription à l’annuaire ou d’un enregistrement d’appelant. Ces opérations ont leurs propres champs obligatoires, autorisations et frais. Utilisez la couverture des attributions pour vérifier la table des préfixes ou la recherche de numéros pour consulter les numéros disponibles à la commande. Aucune de ces opérations ne permet d’établir qu’un appelant est bien la personne qu’il prétend être.