Vérifier la validité d’un numéro

L’API de vérification de numéros de mobile (API HLR) permet de vérifier qu’un numéro de portable existe réellement.

Limite: 360 requêtes par minute.
Si vous dépassez ces limites, vous recevrez une réponse HTTP 429.

URL

POST https://api.smspartner.fr/v1/hlr/notify

Paramètres

Chaque demande d’API prend en charge les paramètres suivants :

apiKey Clé API de votre compte. Vous l’obtenez dans votre compte SMS Partner
phoneNumbers Numéros de mobile à vérifier.
Ils doivent être au format international (+336xxxxxxxx).
Pour l’envoi de plusieurs vérifications les numéros doivent être séparés par des virgules.
500 numéros peuvent être vérifiés par requête.
Paramètres optionnels
tag Chaine de caractère de 20 caractères maximum.
notifyUrl Permet de récupérer le résultat de la requête HLR vers une URL de votre choix.
Le résultat est envoyé en POST.

Exemple de notification d’une requête HLR

_format Format de la réponse. Vous pouvez choisir entre JSON ou XML. Par défaut, le format de réponse est JSON.

Requête

Exemple de requête :

Réponses

Erreurs

Exemple de message d’erreur :

Code de contrôle

Réponse
1 La Clé API est requise
2 Le numéro de téléphone est requis
3 Les numéros doivent être séparés par une virgule
10 Clé API incorrecte
200 Tout s’est bien passé !

Exemple de notification d’une requête HLR

Codes erreur HLR

errorGrpId errorName
0 NO_ERRORAucune erreur.
1 EC_UNKNOWN_SUBSCRIBERLe numéro n’existe pas ou n’a été attribué à aucun abonné actif dans la base de données utilisateur de l’opérateur.
5 EC_UNIDENTIFIED_SUBSCRIBERAbonné non identifié.
6 EC_ABSENT_SUBSCRIBER_SMComme il n’y avait pas de réponse, l’abonné a été détecté comme indisponible. Cela est souvent dû au fait que le combiné est éteint ou dans une zone de faible signal.
7 EC_UNKNOWN_EQUIPMENTLe périphérique mobile n’a pas été reconnu par EIR (Equipment Identity Register) lors de la vérification du périphérique au niveau du protocole MAP sur l’infrastructure de l’opérateur.
8 EC_ROAMING_NOT_ALLOWEDL’abonné est actuellement en itinérance dans un autre pays ou utilise l’infrastructure d’un autre opérateur – la livraison en itinérance n’est pas garantie en raison de l’absence d’accords d’itinérance entre de nombreux opérateurs différents.
9 EC_ILLEGAL_SUBSCRIBERAbonné illégal.
12 EC_ILLEGAL_EQUIPMENTÉquipement illégal.
13 EC_CALL_BARREDL’abonné est configuré sur le service NPD (Ne pas déranger), et ne reçoit aucun trafic de service vers son numéro.
27 EC_ABSENT_SUBSCRIBERL’abonné est hors ligne. Cela est souvent dû au fait que le combiné est éteint.
255 EC_UNKNOWN_ERRORErreur inconnue.