Digital Trust

  1. Home
  2. Libreria API
  3. Digital Trust
Digital Trust è la soluzione migliore per prevenire azioni malevoli sulla tua piattaforma tramite API

Verifica in pochi secondi l’affidabilità e la validità delle informazioni dei tuoi clienti e utenti: dal controllo ed estrazione dei dati dai documenti al video-riconoscimento, dalla verifica del numero di cellulare e dell’email fino al controllo di link e indirizzi IP.

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Digital Trust

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.
Approfondisci Oauth Gestisci i tokens

Fiducia API

Usa i seguenti endpoint per convalidare numeri di telefono, email, URL, indirizzi IP o per eseguire una verifica dell'identità:

Convalida telefono (start)

POST /mobile-start/{mobile-phone-number}

Crea una nuova richiesta per convalidare un numero di cellulare. Il corpo può specificare parametri di callback. Il sistema avvierà un lookup HLR globale sul numero di telefono specificato.
Alcuni operatori mobili e la congestione della rete possono rallentare la richiesta.
Se la ricerca richiede più di 10 secondi, otterrai un risultato parziale con stato "NEW" o "WAIT". Attendi semplicemente una notifica quando la ricerca è terminata. Puoi anche controllare lo stato manualmente utilizzando il metodo GET e l'ID fornito.

Convalida email (start)

POST /email-start/{email}

Crea una nuova richiesta per convalidare un indirizzo email. Il corpo può specificare parametri di callback. Il sistema avvierà un processo di convalida email.
Se la convalida richiede più di qualche secondo, potresti ottenere un risultato parziale con stato 'NEW' o 'WAIT'. Controlla lo stato manualmente usando GET /email-start/{id} o attendi il callback.

Convalida mobile (avanzata)

POST /mobile-advanced/{mobile-phone-number}

Crea una nuova richiesta per una convalida mobile avanzata, incluso punteggio di frode (fraud score), operatore, tipo di linea e altro. Il corpo può specificare parametri di callback. Se la convalida richiede più di qualche secondo, potresti ottenere un risultato parziale con stato 'NEW' o 'WAIT'. Controlla lo stato manualmente usando GET /mobile-advanced/{id} o attendi il callback.

Convalida telefono (avanzata)

POST /phone-advanced/{phone-number}

Crea una nuova richiesta per una convalida avanzata di QUALSIASI numero di telefono, incluso punteggio di frode, operatore, tipo di linea e altro. Il corpo può specificare parametri di callback. Se la convalida richiede più di qualche secondo, potresti ottenere un risultato parziale con stato 'NEW' o 'WAIT'. Controlla lo stato manualmente usando GET /phone-advanced/{id} o attendi il callback.

Convalida email (avanzata)

POST /email-advanced/{email}

Crea una nuova richiesta per una convalida email avanzata, incluso punteggio di frode, recapitalità e reputazione. Il corpo può specificare parametri di callback. Se la convalida richiede più di qualche secondo, potresti ottenere un risultato parziale con stato 'NEW' o 'WAIT'. Controlla lo stato manualmente usando GET /email-advanced/{id} o attendi il callback.

Convalida url (avanzata)

POST /url-advanced/{url}

Crea una nuova richiesta per scansionare un URL alla ricerca di phishing, malware e altre minacce, e valutare il suo punteggio di rischio. Il corpo può specificare parametri di callback. Se la convalida richiede più di qualche secondo, potresti ottenere un risultato parziale con stato 'NEW' o 'WAIT'. Controlla lo stato manualmente usando GET /url-advanced/{id} o attendi il callback.

Convalida ip (avanzata)

POST /ip-advanced/{ip}

Crea una nuova richiesta per analizzare un indirizzo IP alla ricerca di connessioni proxy, VPN o TOR, e valutare il suo punteggio di frode e la reputazione. Il corpo può specificare parametri di callback. Se la convalida richiede più di qualche secondo, potresti ottenere un risultato parziale con stato 'NEW' o 'WAIT'. Controlla lo stato manualmente usando GET /ip-advanced/{id} o attendi il callback.

Verifica Identità (start)

POST /idv-flash-start

Crea una nuova richiesta per eseguire una Verifica dell'Identità. Il corpo può specificare parametri di callback. Restituirà un URL di verifica verso un codice QR. Segui la procedura con il tuo smartphone e attendi il risultato (circa 3 min). L'intero processo è verificato dall'IA. Controlla lo stato manualmente usando GET /idv-flash-start/{id} o attendi il callback.

Verifica Identità (avanzata)

POST /idv-flash-advanced

Crea una nuova richiesta per eseguire una Verifica dell'Identità. Il corpo può specificare parametri di callback. Restituirà un URL di verifica verso un codice QR. Segui la procedura con il tuo smartphone e attendi il risultato (circa 3 min). L'intero processo è verificato dall'IA e include anche la cattura del volto. Controlla lo stato manualmente usando GET /idv-flash-advanced/{id} o attendi il callback.

Verifica Identità (expert)

POST /idv-expert

Crea una nuova richiesta per eseguire una Verifica dell'Identità. Il corpo può specificare parametri di callback. Restituirà un URL di verifica verso un codice QR. Segui la procedura con il tuo smartphone e attendi il risultato (circa 3 ore). Il processo di verifica è eseguito dall'IA e sarà poi convalidato da un esperto. Controlla lo stato manualmente usando GET /idv-flash-advanced/{id} o attendi il callback.

Recuperare una richiesta di convalida

GET /mobile-start/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /email-start/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /mobile-advanced/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /phone-advanced/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /email-advanced/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /url-advanced/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /ip-advanced/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state")

GET /idv-flash-start/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state"). Puoi anche aggiungere uno tra "front" o "back" come parametro aggiuntivo (es. GET /idv-flash-start/{id}/front) per recuperare rispettivamente l'immagine frontale o posteriore del documento, o in alternativa usare l'header "Content-Type: application/pdf" con solo l'{id} per ottenere un report pdf completo della verifica contenente entrambe le immagini, più i dati di verifica.

GET /idv-flash-advanced/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state"). Puoi anche aggiungere uno tra "front", "back" o "face" come parametro aggiuntivo (es. GET /idv-flash-advanced/{id}/face) per recuperare rispettivamente l'immagine frontale del documento, l'immagine posteriore o il volto catturato durante il processo, o in alternativa usare l'header "Content-Type: application/pdf" con solo l'{id} per ottenere un report pdf completo della verifica contenente tutte e 3 le immagini, più i dati di verifica.

GET /idv-expert/{id}
Restituisce il dettaglio di una richiesta per controllare lo stato ("state"). Puoi anche aggiungere uno tra "front", "back" o "face" come parametro aggiuntivo (es. GET /idv-expert/{id}/back) per recuperare rispettivamente l'immagine frontale del documento, l'immagine posteriore o il volto catturato durante il processo, o in alternativa usare l'header "Content-Type: application/pdf" con solo l'{id} per ottenere un report pdf completo della verifica contenente tutte e 3 le immagini, più i dati di verifica.

API docs by Redocly

Trust (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Utilizzate questa API per verificare la validità e l'attendibilità di dati quali indirizzi e-mail e numeri di cellulare.

Prima volta qui? Generare un nuovo token di accesso

HLR

interrogazione "Home Location Register" per la convalida dei numeri di telefono cellulare

Recuperare una richiesta

Restituisce un dettaglio della richiesta per controllare lo "stato"

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 66c881896de559cb65055392

id della richiesta ottenuto con il metodo "POST

Responses

Response Schema: application/json
object (mobile-start)
success
boolean
message
string
error
string

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://trust.openapi.com/mobile-start/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": ""
}

Creare una nuova richiesta HLR

Creare una nuova richiesta; il post del corpo viene utilizzato per specificare i parametri di "callback". Il sistema avvierà una ricerca HLR globl sul numero di telefono specificato.
Alcuni operatori di telefonia mobile e la congestione della rete possono rallentare la richiesta. Se la ricerca dura più di 10 secondi, si otterrà un risultato parziale con uno stato di "NEW" o "WAIT". Attendere una notifica al termine della ricerca. È anche possibile verificare lo stato manualmente utilizzando il metodo GET e l'ID fornito.

Authorizations:
bearerAuth
path Parameters
mobile-phone-number
required
string
Example: +393939989747

Il telefono cellulare completo di prefisso internazionale

Request Body schema: application/json
object

È il nostro sistema di callback OpenAPI standardizzato. Consente di configurare i parametri per ricevere notifiche sugli aggiornamenti di stato delle richieste asincrone a questo endpoint.

Responses

Response Schema: application/json
object (mobile-start)
success
boolean
message
string
error
string

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Email

Servizi di convalida delle e-mail

Recuperare una richiesta di convalida di un'e-mail

Restituisce un dettaglio della richiesta di convalida dell'e-mail per controllare lo "stato" e i risultati.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 77e9e92216065fa37f3c9842

ID della richiesta ottenuto con il metodo POST /email-start/{email}

Responses

Response Schema: application/json
object (email-start)
success
boolean
message
string
error
string

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://trust.openapi.com/email-start/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Creare una nuova richiesta di convalida dell'e-mail

Crea una nuova richiesta per convalidare un indirizzo e-mail. Il corpo può specificare parametri di callback. Il sistema avvierà un processo di convalida dell'email. Se la convalida richiede più di qualche secondo, si potrebbe ottenere un risultato parziale con lo stato "NEW" o "WAIT". Verificare manualmente lo stato utilizzando GET /email-start/{id} o attendere il callback.

Authorizations:
bearerAuth
path Parameters
email
required
string <email>

L'indirizzo e-mail da convalidare.

Request Body schema: application/json
object

È il nostro sistema di callback OpenAPI standardizzato. Consente di configurare i parametri per ricevere notifiche sugli aggiornamenti di stato delle richieste asincrone a questo endpoint.

Responses

Response Schema: application/json
object (email-start)
success
boolean
message
string
error
string

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}
Web Service Revision: 2.0.0