Nel mondo digitale di oggi, è molto importante assicurarsi che i numeri di telefono siano reali e funzionino bene sia per le aziende che per i privati. La necessità di controllare i numeri di telefono ha portato allo sviluppo di nuove tecnologie, come l’API HLR Lookup. Questo utile strumento aiuta a verificare i numeri di cellulare e di rete fissa in tutto il mondo, aiutando a prevenire le frodi, a migliorare la comunicazione e a connettersi meglio con i clienti. È fondamentale disporre di un buon sistema di verifica dei telefoni, in quanto influisce direttamente sul modo in cui comunichiamo e proteggiamo le nostre conversazioni personali e di lavoro.

Questo articolo spiega come utilizzare l’API HLR Lookup per verificare i numeri di telefono. Inizieremo con un’introduzione all’API HLR Lookup e poi ti forniremo una guida passo passo su come utilizzarla al meglio. Imparerai a interrogare l’API, a capire le risposte che ricevi e a conoscere il significato di ogni dato che l’API ti fornisce. Alla fine della lettura, saprai come convalidare i numeri di telefono in modo sicuro, assicurandoti che i tuoi contatti siano corretti e affidabili.

Panoramica dell’API di ricerca HLR

HLR Lookup è un potente strumento per verificare la validità e lo stato dei numeri di cellulare. HLR è l’acronimo di Home Location Register, un database centralizzato utilizzato dagli operatori di rete mobile per memorizzare le informazioni sugli abbonati alle loro reti.

Che cos’è l’HLR?

HLR è l’abbreviazione di Home Location Register, un database centralizzato utilizzato dagli operatori di rete mobile per memorizzare le informazioni sugli abbonati alle loro reti. La verifica del lookup HLR consente alle aziende di determinare se un numero di telefono cellulare è valido, attivo e registrato sulla rete di uno specifico operatore mobile.

Importanza della convalida del numero di telefono

La convalida dei numeri di telefono è fondamentale per diversi motivi:

1. Garantisce l’accuratezza dei dati di contatto dei clienti, aiutando a evitare errori e incomprensioni nella comunicazione.
2. Aiuta le aziende a proteggersi da frodi e tentativi di phishing verificando la validità dei numeri di cellulare.
3. Migliora l’efficienza operativa e la redditività evitando di inviare messaggi o chiamate a numeri errati o non validi.

Casi d’uso

L’API HLR Lookup trova applicazione in diversi settori, tra cui:

• Telecomunicazioni: Le compagnie di telefonia mobile possono utilizzare la ricerca HLR per convalidare i numeri di cellulare dei loro clienti e garantire una comunicazione efficiente.
• Marketing e pubblicità: la ricerca HLR può essere utilizzata per garantire che i messaggi di testo e le telefonate raggiungano i clienti giusti, evitando così di sprecare risorse.
• Settore finanziario: la verifica della ricerca HLR è essenziale per garantire la sicurezza delle transazioni e proteggere i clienti dalle frodi.

In breve, l’API HLR Lookup è uno strumento essenziale per qualsiasi azienda che si basa su una comunicazione efficace con i propri clienti. Verificando la validità e lo stato dei numeri di cellulare, le aziende possono migliorare l’accuratezza dei loro dati di contatto, aumentare l’efficienza operativa e proteggersi dalle frodi. Per maggiori informazioni, visita la sezione Controllare il telefono con HLR Lookup API.

Una guida passo passo all’utilizzo dell’API di ricerca HLR

Per iniziare a usare l’API per convalidare i numeri di telefono, segui questi passaggi:

Registrati e ottieni la tua chiave API

1. Crea un account su verificaremails.com. La registrazione richiederà solo pochi minuti.
2. Una volta registrato, richiedi la tua prova gratuita. Questo ti fornirà un saldo di prova per eseguire le convalide con l’API.
3. Ottieni la tua chiave API dalla sezione Impostazioni API del tuo account. Questa chiave sarà utilizzata come password per accedere all’API.

Configurazione e integrazione di base

1. Familiarizza con l’URL dell’endpoint dell’API HLR: https://dashboard.verificaremails.com/myapi/phone/validate/single
2. Il metodo di autenticazione utilizzato è Basic Auth HTTP. username:tokenapi base64()Includi le tue credenziali nell’intestazione della richiesta HTTP codificata a .
3. I parametri principali di una query HLR sono:
   • numbersNumeri di telefono da convalidare nel formato internazionale E.164 senza “+” o “00”. Puoi includere un singolo numero o un elenco separato da virgole (massimo 100).
   • typeTipo di test HLR. Valori possibili: “phone”, “phonemnp”, “phonesintactic” indicati nella struttura della chiamata.
4. Il risultato della richiesta viene ottenuto in formato JSON con informazioni dettagliate su ogni numero.

Esempi di codice

Ecco un esempio di come eseguire una query HLR utilizzando PHP:

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://dashboard.verificaremails.com/myapi/phone/validate/single?term=34677934019&auth-token={{api_token}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Questo codice esegue una query HLR per convalidare lo stato di un numero di telefono. Puoi adattarlo alle tue esigenze.

Ricorda che Verificaremails offre librerie e plugin per facilitare l’integrazione con diversi linguaggi di programmazione e piattaforme.

Se hai domande o hai bisogno di assistenza durante il processo di integrazione, non esitare a contattare il team di assistenza tecnica. Ti consigliamo di visualizzare il file Postman con le chiamate API HLR.

Effettuare chiamate API

Per effettuare le chiamate all’API HLR Lookup, puoi utilizzare le richieste HTTP GET o POST. https://dashboard.verificaremails.com/myapi/phone/validate/single L’endpoint dell’API è .

Convalida di un singolo numero

Per convalidare un singolo numero di telefono, fai una richiesta GET all’endpoint API con i seguenti parametri:

• phone_numberIl numero di telefono che vuoi convalidare in formato internazionale (ad esempio +34677934019).
• apikeyLa tua chiave API fornita da Verificaremails.

Esempio di richiesta con cURL:

curl -X 'GET' \
  'https://dashboard.verificaremails.com/myapi/phone/validate/single?auth-token={{token}}&term=34677934019' \
  -H 'accept: application/json'

La risposta dell’API sarà un oggetto JSON con informazioni dettagliate sul numero di telefono, tra cui la validità, il gestore, lo stato di portabilità e altro ancora.

Convalida del numero di lotto

Per convalidare più numeri di telefono contemporaneamente, puoi utilizzare la funzione di convalida batch dell’API. Effettua una richiesta POST allo stesso endpoint con i seguenti parametri:

• phone_numbersUn elenco separato da virgole di numeri di telefono in formato internazionale.
• apikeyLa tua chiave API fornita da Verificaremails.
• fileIl file contenente i numeri di telefono da convalidare.
• columnLa colonna in cui si trovano i numeri all’interno del file.
• send_emailL’indirizzo e-mail a cui notificare il completamento della verifica.
• callback_urlL’URL di chiamata per notificare la fine della verifica.

Esempio di richiesta con cURL:

curl -X 'POST' \
  'https://dashboard.verificaremails.com/myapi/phone/validate/multiple?auth-token=%7B%7Btoken%7D%7D' \
  -H 'accept: application/json' \
  -H 'Content-Type: multipart/form-data' \
  -F '[email protected];type=text/plain' \
  -F 'column=1' \
  -F 'send_email=0' \
  -F 'callback_url=http://webhoock.com'

La risposta dell’API sarà un oggetto JSON con informazioni dettagliate su ogni numero di telefono dell’elenco.

TU_CLAVE_API Ricordati di sostituirla con la tua vera chiave API fornita da verificaremails.com. Inoltre, assicurati di gestire correttamente le risposte API nel tuo codice, compresa la gestione degli errori e l’interpretazione dei dati restituiti.

Per maggiori informazioni sui parametri aggiuntivi e sui codici di risposta dell’API, consulta la documentazione completa dell’API HLR Lookup.

Interpretare le risposte API

Una volta effettuata la richiesta all’API, riceverai una risposta in formato JSON contenente informazioni dettagliate sul numero di telefono convalidato. È fondamentale comprendere la struttura della risposta e i campi comuni per interpretare correttamente i risultati.

Comprendere la struttura della risposta

La risposta dell’API viene restituita in formato JSON, un formato di interscambio dati leggibile e facile da analizzare. La struttura tipica della risposta comprende i seguenti elementi:

1. id	Tipo	Valore nullo	Descrizione
   id	stringa		ID univoco della richiesta.
   costo	galleggiante		Numero di token utilizzati nella verifica.
   numero_di_telefono	stringa		Numero di telefono in formato E.164.
   tipo_numero	stringa		Tipo di numero di telefono (fisso o mobile) Tipi di numero
   fuso orario	stringa		Fuso orario in cui il numero è stato originariamente assegnato. In nessun caso traccia il fuso orario in cui si trova l’utente al momento della verifica.
   is_ported	bool	✓	Indica se il numero è stato trasferito. Se l’informazione non è disponibile, viene visualizzato un valore nullo.
   raggiungibile	stringa		L’accessibilità è indicata nel momento esatto della verifica. Per ulteriori informazioni, vedere Stato di raggiungibilità.
   imsi	stringa	✓	Identità internazionale dell’abbonato mobile (IMSI). Identificatore univoco associato alla carta SIM. La disponibilità dell’IMSI dipende dall’operatore mobile della carta.
   formato.e164	stringa		Il numero in formato E.164.
   formato.internazionale	stringa		Il numero in formato internazionale.
   formato.nazionale	stringa		Il numero in formato nazionale.
   formato.rfc3966	stringa		Il numero formattato nel formato RFC3966.
   rete_originale.paese_iso2	stringa		Il codice del paese (ISO2) in cui il numero è stato originariamente assegnato.
   rete_originale.prefisso_paese	stringa		Il prefisso internazionale a cui il numero è stato originariamente assegnato.
   rete_originale.area	stringa	✓	Il nome dell’area in cui è stato assegnato il numero.
   rete_originale.mccmnc	stringa	✓	Cinque o sei caratteri MCCMNC (codice del paese mobile + tupla del codice della rete mobile) che identificano la rete originale che ha emesso il numero.
   rete_originale.mcc	stringa	✓	Tre caratteri MCC (mobile country code) che identificano la rete in cui è stato emesso il numero.
   rete_originale.mnc	stringa	✓	Due o tre caratteri MNC (mobile network code) che identificano la rete in cui è stato emesso il numero.
   nome_rete_originale	stringa	✓	Nome dell’operatore che ha rilasciato il numero, se disponibile.
   rete_attuale.paese_iso2	stringa	✓	Codice del paese (ISO2) in cui il numero è attualmente assegnato.
   rete_attuale.prefisso_paese	stringa		Il prefisso internazionale a cui il numero è attualmente assegnato.
   rete_attuale.area	stringa	✓	Nome dell’area in cui il numero è attualmente assegnato, se disponibile.
   rete_attuale.mccmnc	stringa	✓	Cinque o sei caratteri MCCMNC (codice del paese mobile + tupla del codice della rete mobile) che identificano la rete a cui appartiene attualmente il numero.
   rete_attuale.mcc	stringa	✓	Tre caratteri MCC (mobile country code) che identificano il paese a cui il numero appartiene attualmente.
   rete_attuale.mnc	stringa	✓	Due o tre caratteri MNC (mobile network code) che identificano la rete a cui il numero appartiene attualmente.
   nome_rete_corrente.nome_rete	stringa	✓	Il nome dell’operatore a cui il numero è attualmente assegnato, se disponibile.

Campi di risposta comuni

Alcuni dei campi più importanti della risposta API sono:

Gestione degli errori e risoluzione dei problemi

Se la risposta dell’API indica un errore (status: false), il campo “message” deve fornire i dettagli del problema. Alcuni errori comuni sono:

• Chiave API non valida o mancante
• Numero di telefono non valido o in formato errato
• Stanziamenti insufficienti nel conto

Per risolvere questi problemi, controlla che tu stia utilizzando la chiave API corretta, che il numero di telefono sia nel formato internazionale corretto e che tu abbia abbastanza crediti nel tuo account.

Se il campo “risultato” mostra “sconosciuto”, ciò potrebbe indicare che tutti i crediti sono stati esauriti. In questo caso, dovrai ricaricare il tuo account per continuare a utilizzare il servizio di verifica del numero di telefono.