In questo articolo scoprirai come utilizzare l’API HLR Lookup per convalidare i numeri di telefono in tempo reale. Vedrai come eseguire convalide individuali, convalide di massa tramite file e come automatizzare i processi per creare un validatore di numeri tramite l’API. Vedremo diversi esempi di codice, concentrandoci su alcuni linguaggi come PHP e JavaScript. Infine, vedremo come utilizzare la documentazione dell’API per la verifica del numero di telefono.
Che cos’è un’API REST?
Una
API REST
(Application Programming Interface Representational State Transfer) è una forma di comunicazione tra sistemi che utilizza le convenzioni HTTP. Immagina che sia un messaggero che trasporta richieste e risposte tra la tua applicazione e un server. Le API REST sono molto utilizzate per la loro semplicità ed efficienza.
Componenti principali di un’API REST
Risorse
Rappresentano dati, come utenti o prodotti.
Verbi HTTP
Metodi come GET, POST, PUT e DELETE per interagire con le risorse.
Endpoint
URL che indicano dove si trova una specifica risorsa.
Formato dei dati
Di solito JSON o XML.
Esempio pratico: verifica del numero di telefono con HLR Lookup
Verifica dei numeri di telefono utilizzando
Ricerca HLR
(Home Location Register Lookup) permette di sapere se un numero è valido e attivo. Questo è utile per le aziende che vogliono assicurarsi che i loro messaggi raggiungano i giusti destinatari.
Processo di verifica
Invia una richiesta
con il numero di telefono all’API HLR Lookup.
L’API di convalida interroga
il database HLR dell’operatore telefonico.
Ricevi una risposta
che indica lo stato del numero di telefono.
Implementazione passo dopo passo utilizzando l’API di verificamails.com
Registrati
su verificaremails.com e ottieni la tua chiave API.
Invia una richiesta GET
all’API di convalida del HLR Lookup.
curl -X GET "https://www.verificaremails.com/api/v1/hlr?phone_number=1234567890" -H "apikey: TU_CLAVE_API"
Interpreta la risposta
. Un esempio di risposta potrebbe essere:
{
"status": "success",
"data": {
"phone_number": "1234567890",
"valid": true,
"carrier": "Movistar",
"country": "ES"
}
}
Possiamo ottenere ulteriori informazioni sul numero di telefono, in particolare se si tratta di un numero di cellulare, nel file JSON della risposta.
Formato della risposta
Se entriamo nel dettaglio, oltre a indicare se il numero è valido o meno, possiamo ottenere informazioni sull’operatore telefonico, sul tipo di linea, sul formato internazionale del numero… Se vuoi sapere se il numero è valido, devi guardare i campi IMSI, MCC, MNC e MCCMNC. Tutti questi controlli vengono eseguiti dall’API di validazione e visualizzati nel valore del campo “raggiungibile”.
IMSI
L’IMSI
IMSI
(International Mobile Subscriber Identity) è un numero unico associato a ciascun utente della rete mobile. Questo numero è memorizzato sulla carta SIM e viene utilizzato dalle reti mobili per identificare gli abbonati.
Componenti dell’IMSI
L’IMSI è composto da tre parti:
MCC (Mobile Country Code)
Codice a tre cifre che identifica il paese dell’abbonato.
MNC (Mobile Network Code)
Codice a due o tre cifre che identifica la rete mobile del paese.
MSIN (Mobile Subscriber Identification Number)
Numero unico che identifica l’abbonato all’interno della rete mobile.
MCC e MNC
MCC
Ogni paese ha una CQI unica. Ad esempio, la Spagna ha MCC 214.
MNC
Gli operatori all’interno di un paese hanno NQF diversi. Ad esempio, in Spagna, Movistar ha la MNC 07.
MCCMNC
Il
MCCMNC
è la combinazione di MCC e MNC. Viene utilizzato per identificare in modo univoco una rete mobile in un paese. Ad esempio, l’MCCMNC di Movistar in Spagna sarebbe 21407.
Verifica del numero di telefono
Per verificare se un numero di telefono è autentico utilizza l’IMSI:
Ottenere l’IMSI
Ottenere l’IMSI: estrai l’IMSI dalla scheda SIM del telefono.
Analisi dell’IMSI
:-
- Estrai l’MCC e l’MNC dall’IMSI.
- Verifica che l’MCC corrisponda al paese previsto.
- Verifica che l’MNC corrisponda a un operatore valido in quel paese.
Convalida
:-
- Controlla che l’MCCMNC esista e sia valido.
- Assicurati che il MSIN sia corretto e attivo nella rete.
Esempio
Se hai un IMSI 214071234567890, puoi suddividerlo in questo modo:
MCC
: 214 (Spagna)
MNC
: 07 (Movistar)
MSIN
1234567890 (Subscriber Unique Identifier)
Verificando l’MCC e l’MNC, puoi confermare che il numero di telefono appartiene a un abbonato Movistar in Spagna, il che aiuta a convalidarne l’autenticità.
{
“id”: “364215”,
“termine”: “34677934019”,
“request_id”: “364215”,
“codice_risultato”: “101”,
“result_type”: “Connected”,
“risultato”: {
“phone_number”: “+34677934019”,
“number_type”: “mobile”,
“timezone”: “Atlantic/Canary”,
“formato”: {
“e164”: “+34677934019”,
“internazionale”: “+34 677 93 40 19”,
“nazionale”: “677 93 40 19”,
“rfc3966”: “tel:+34-677-93-40-19”
},
“is_ported”: true,
“raggiungibile”: “connesso”,
“processing_status”: “completed”,
“imsi”: “214040000000000”,
“current_network”: {
“country_iso2”: “EN”,
“prefisso_paese”: “34”,
“Nome_paese”: “Spagna”,
“mccmnc”: “21404”,
“mcc”: “214”,
“mnc”: “04”,
“area”: “IT”,
“Nome_rete”: “Yoigo”.
},
“rete_originale”: {
“country_iso2”: “EN”,
“prefisso_paese”: “34”,
“Nome_paese”: “Spagna”,
“mccmnc”: “21401”,
“mcc”: “214”,
“mnc”: “01”,
“area”: “IT”,
“Nome_rete”: “Vodafone”.
}
}
}
Come creare un validatore di numeri di telefono con PHP
Per facilitare l’uso del validatore telefonico nei tuoi moduli e nelle tue applicazioni, abbiamo creato una libreria POSTMAN da cui puoi scaricare le chiamate api e gli esempi di codice. Nel caso del nostro esempio, se vogliamo effettuare una chiamata in PHP, dobbiamo selezionare questo linguaggio dalla raccolta Postman e l’applicazione stessa genererà la chiamata PHP per convalidare un numero di telefono.
Perché convalidare i numeri di telefono
Catturare lead è costoso e lo diventerà ogni giorno di più. Si stima che tra l’8 e il 12% dei telefoni acquisiti nei moduli o durante i processi di registrazione siano errati. La verifica dei dati nel punto di raccolta può rilevare questi errori e migliorare i tassi di registrazione.
Una volta catturato, il lead entra in un “imbuto di vendita” per essere sfruttato. Se il numero di telefono è errato, stiamo destinando risorse che non avranno mai un ritorno. Il nostro consiglio è di controllare tutti i numeri di telefono al momento dell’assunzione, ma se non l’hai fatto, controlla almeno il database per avere un quadro reale dei tuoi potenziali clienti.
Conclusioni
Abbiamo visto i diversi modi di convalidare i numeri di telefono. Abbiamo visto che questo servizio è adatto alla verifica dei numeri di cellulare durante i processi di registrazione, migliorando la qualità dei dati ed evitando l’acquisizione di numeri non validi. Ricorda che puoi applicare la convalida HLR Lookup a singoli telefoni, in modo massiccio a file con un alto volume di numeri o automatizzando il processo con l’API di convalida dei numeri.
Ti consigliamo di consultare la documentazione dell’API di convalida del telefono per le diverse chiamate e se vuoi avere accesso alle librerie di convalida nei diversi linguaggi di programmazione. Anche se le chiamate API sono di tipo Rest, ti faciliteranno sempre l’integrazione del servizio.
