• it
    • fr
    • en
    • pt-pt
    • es

Verifica della validità di un numero

Questa funzione verifica l’effettiva esistenza di un numero di cellulare.

Limite: 360 richieste al minuto.
Se si superano questi limiti, si riceve una risposta HTTP 429.

URL

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

Impostazioni

Ogni richiesta PLC supporta i seguenti parametri :

apiKey API key per il tuo account. Si ottiene nel vostro account Partner SMS
phoneNumbers Numeri di cellulare da controllare.
Devono essere in formato internazionale (+336xxxxxxxxxxxxxxxxxxxx).
Quando si inviano più controlli, i numeri devono essere separati da virgole.
500 numeri possono essere verificati per ogni richiesta.
Parametri opzionali
notifyUrl Consente di recuperare il risultato della query HLR ad un URL di vostra scelta. Il risultato viene inviato in POST.

Esempio di notifica di una richiesta HLR

_format Formato della risposta. È possibile scegliere tra JSON o XML. Per impostazione predefinita, il formato di risposta è JSON.

Richiesta

Interrogazione campione :

Risposte

Errori

Esempio di messaggio di errore :

Codice di controllo

Rispondi a
1 La chiave API è richiesta
2 Il numero di telefono è obbligatorio
3 I numeri devono essere separati da una virgola.
10 Chiave API errata
200 È andato tutto bene!

Esempio di notifica di una richiesta HLR HLR

Codici di errore HLR

errorGrpId errorName
0 NO_ERRORNessun errore.
1 EC_UNKNOWN_SUBSCRIBER Il numero non esiste o non è stato assegnato ad alcun abbonato attivo nel database utenti del gestore.
5 EC_UNIDENTIFIED_SUBSCRIBER Sottoscrittore non identificato.
6 EC_ABSENT_SUBSCRIBER_SM Poiché non c’è stata risposta, l’abbonato è stato rilevato come non disponibile. Ciò è spesso dovuto al fatto che il portatile è spento o in una zona con segnale basso.
7 EC_UNKNOWN_EQUIPMENT Il dispositivo mobile non è stato riconosciuto dall’EIR (Equipment Identity Register) quando ha controllato il dispositivo rispetto al protocollo MAP sull’infrastruttura dell’operatore.
8 EC_ROAMING_NOT_ALLOWED L’abbonato è attualmente in roaming in un altro paese o utilizza l’infrastruttura di un altro operatore – la fornitura di roaming non è garantita a causa della mancanza di accordi di roaming tra molti operatori diversi.
9 EC_ILLEGAL_SUBSCRIBER Abbonato illegale.
12 EC_ILLEGAL_EQUIPMENT Attrezzature illegali.
13 EC_CALL_BARRED L’abbonato è impostato sul servizio NPD (Do Not Disturb) e non riceve alcun traffico di servizio verso il suo numero.
27 EC_ABSENT_SUBSCRIBER L’abbonato è offline. Ciò è spesso dovuto al fatto che il portatile è spento. EC_UNKNOWN_ERROR Errore sconosciuto..
255 EC_UNKNOWN_ERRORErreur inconnue.