Vérification de format
Cette requête est utilisée pour vérifier le format d'un numéro de téléphone portable. Elle est disponible gratuitement.
URL
POST
https://api.smspartner.fr/v1/lookup
Limite de 360 requêtes par minute. Si vous dépassez ces limites vous recevrez une réponse HTTP 429.
Paramètres obligatoires
apiKey
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
_format
json
ou xml
Requêtes
<?php
// Prepare data for POST request
$fields = array(
'apiKey'=> 'YOUR API KEY',
'phoneNumbers'=> '+336xxxxxxxx'
);
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/lookup');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields));
$result = curl_exec($curl);
curl_close($curl);
// Process your response here
echo $result;
?>
Réponse
{
"success": true,
"code": 200,
"lookup": [
{
"request": "336XXXXXXXX",
"success": true,
"countryCode": "France",
"prefixCode": 33,
"phoneNumber": "+336XXXXXXXX",
"type": "Mobile",
"network": "",
"format": {
"e164": "+336XXXXXXXX",
"international": "+33 6 XX XX XX XX",
"national": "06 XX XX XX XX",
"rfc3966": "tel:+33-6-XX-XX-XX-XX"
}
}
]
}
Erreurs
{
"success": false,
"code": 10,
"message": "Clé API incorrecte"
}
Code erreurs
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
Array(
'phone' => '+3300000000',
'messageId'=>'1234-12344-1234-1234',
'mccMnc' => '20815',
'ported'=> 1,
'errorGrpId'=> 0,
'errorName'=> 'NO_ERROR ',
'errorDesc'=>'No Error' ,
'date'=>'2018-03-05T10:34:52.355+0000'
)
Code erreurs HLR
0
NO_ERROR
Aucune erreur.
1
EC_UNKNOWN_SUBSCRIBER
Le 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_SUBSCRIBER
Abonné non identifié.
6
EC_ABSENT_SUBSCRIBER_SM
Comme 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_EQUIPMENT
Le 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_ALLOWED
L’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_SUBSCRIBER
Abonné illégal.
12
EC_ILLEGAL_EQUIPMENT
Équipement illégal.
13
EC_CALL_BARRED
L’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_SUBSCRIBER
L’abonné est hors ligne. Cela est souvent dû au fait que le combiné est éteint.
255
EC_UNKNOWN_ERROR
Erreur inconnue.
Dernière mise à jour