Trust è la soluzione migliore per prevenire azioni malevoli sulla tua piattaforma tramite API
Verifica la validità delle informazioni dei tuo clienti e utenti in pochi secondi: dal numero di cellulare, all'email ai dati personali.
Per effettuare una richiesta a POST /mobile-start/{mobile-phone-number} è necessario passare il parametro ‘Numero di telefono cellulare’, completo di prefisso internazionale.
La risposta fornisce le seguenti informazioni sul numero di telefono ricercato:
- validità numero di cellulare
- codice Paese
- Paese
- validità numero rispetto a Paese
- tipo di numero (nel nostro caso sarà sempre mobile)
- numero inserito
- numero formattato
- data e orario richiesta
- data aggiornamento
- stato richiesta (NEW, WAIT, DONE)
- operatore originario
- operatore attuale
- roaming
- ported (cioè cambiamento di operatore con stesso numero)
- prefisso Paese numero cellulare
- dettaglio
- id richiesta
I tempi medi di risposta sono di pochi secondi.
In fase di richiesta è possibile anche impostare una callback così da ricevere una notifica quando la risposta è disponibile.
Nel caso in cui non sia possibile gestire la richiesta entro i primi 10 secondi, verrà restituita una risposta parziale, con stato ‘NEW’, e relativo id per gestire la richiesta in modalità asincrona tramite il metodo GET/mobile-start/{id}.
Per effettuare una richiesta a GET/mobile-start/{id} è necessario il parametro ID, ottenuto con il metodo POST /mobile-start/.
La risposta fornisce i dettagli di una precedente ricerca, per controllarne lo stato e verificare le informazioni disponibili.
Sì, in fase di richiesta a POST /mobile-start si può impostare anche una callback e ricevere così una notifica quando la risposta è disponibile.
Sono tre i possibili stati della richiesta all’endpoint POST /mobile-start/:
- NEW: quando la richiesta è stata appena effettuata e si attende che venga presa in carico
- WAIT: è lo stato intermedio, che indica che la richiesta deve ancora essere processata
- DONE: indica che la richiesta è stata processata e, in quel caso, sarà disponibile la risposta completa, comprensiva di tutti i dati
Il servizio è disponibile in 56 paesi e con più di 260 operatori.
La risposta viene restituita entro 10 secondi.
Se non è possibile gestire la richiesta entro i primi 10 secondi, verrà restituita una risposta parziale, con stato ‘NEW’, e con relativo id per gestire la richiesta in modalità asincrona attraverso il metodo GET/mobile-start/{id}.
Nel frattempo sarà comunque possibile visualizzare i seguenti dati:
- validità numero di cellulare
- codice Paese
- Paese
- validità numero rispetto a Paese
- tipo di numero (nel nostro caso sarà sempre mobile)
- numero inserito
- numero formattato
- data e orario richiesta
- data aggiornamento
Sì, per l’endpoint GET/mobile-start/{id} - che consente di recuperare i dettagli di una precedente richiesta - sono previste 1440 chiamate gratuite/al giorno.
Sì, ad oggi è possibile attivare l’abbonamento annuale per il servizio HLR, e risparmiare quindi sul costo della singola chiamata.
Nella sezione Abbonamenti dell’API specifica puoi vedere le opzioni disponibili (con i relativi prezzi e la percentuale di risparmio) e puoi anche attivare l’abbonamento che preferisci.
Sono tre i possibili stati della richiesta all’endpoint POST /mobile-start/:
- NEW: quando la richiesta è stata appena effettuata e si attende che venga presa in carico
- WAIT: è lo stato intermedio, che indica che la richiesta deve ancora essere processata
- DONE: indica che la richiesta è stata processata e, in quel caso, sarà disponibile la risposta completa, comprensiva di tutti i dati
Il costo della richiesta singola per l’endpoint POST /mobile-start/ è a partire da 0,050€ (0,008€ se si sceglie l’abbonamento).
Per il primo endpoint GET/mobile-start/{id} viene applicata la politica di buon uso per cui sono gratuite fino a 1440 chiamate/al giorno, poi è previsto un addebito pari a 0,001€ per singola richiesta.
Nella sezione Utilizzo, a livello di API, è possibile monitorare le richieste gratuite ed effettuate tramite abbonamento o ricarica. Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.
No, puoi effettuare tutte le richieste che desideri. Tuttavia, l'API è in grado di gestirne fino a 50 al minuto. Se il numero di richieste supera questo limite, verrà restituita una risposta parziale con stato "NEW" e un ID univoco. Potrai quindi completare l'elaborazione della richiesta in modalità asincrona utilizzando il metodo GET /mobile-start/{id}.