API HLR Lookup

Avec l'API de CaptainVerify, vous pouvez intégrer la vérification HLR Lookup dans vos propres applications. Nous conseillons d'utiliser l'API a posteriori car une vérification peut être plus ou moins longue (1 voire 2 minutes).

Clé API

Un compte est nécessaire pour générer la clé pour l'API, c'est ce qui vous donnera accès au service.

La requête

Pour faire une demande à l'API, appelez simplement le protocole GET à cette URL:

https://api.captainverify.com/verify?phone={PHONE_NUMBER}&apikey=XXXXXXXXXXXXXXXXXXXX

Remplacez {PHONE_NUMBER} par le numéro mobile à vérifier

Limites de l'API

L'API est limitée à un maximum de 2 connexions simultanées et 50 vérifications par minute. Lorsque vous intégrez l'API, assurez-vous que votre application ne dépasse pas cette limite.

La réponse

Une table json sera renvoyée avec ces variables:

Variables Valeur possible

status

true, false.
Le statut de la requete.

credits

89
Crédits disponibles sur votre compte.

message

default : null
Lorsque le status est faux, un message d'erreur sera envoyé.

requested_number

0600000000
Le numéro mobile à interroger.

formatted_number

+33600000000
Le numéro mobile format international.

network

Free Mobile
Le nom du réseau.

original_network

Orange
Le nom d'origine du réseau.

roaming

true, false
L'état d'itinérance actuel.

ported

true, false
Si l'utilisateur a changé d'opérateur avec le même numéro.

country

France
Le nom complet du pays pour le numéro demandé.

country_prefix

33
Le préfixe numérique du pays du numéro.

details

DELIVERED_TO_HANDSET, UNDELIVERABLE_NOT_DELIVERED
DELIVERED_TO_HANDSET : La vérification HLR a été traité (numéro attribué).
UNDELIVERABLE_NOT_DELIVERED: La vérification HLR n'a pas été jusqu'au bout (numéro non attribué).

result

Le statut du numéro : valid, invalid, unknow
Si tous vos crédits ont été épuisés, le statut inconnu sera toujours retourné, pour ne pas bloquer votre application.

Pour connaître la validité d'un numéro mobile en temps réel.
Inscrivez-vous dès maintenant