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.

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.

API Trust

Utilizza 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 della richiesta (body) può specificare parametri di callback. Il sistema avvierà una ricerca 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 al termine della ricerca. 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 body può specificare parametri di callback. Il sistema avvierà un processo di convalida dell'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 la callback.

Convalida telefono (advanced)

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

Crea una nuova richiesta per una convalida avanzata del cellulare, inclusi punteggio frode, operatore, tipo di linea e altro. Il body 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 la callback.

Convalida email (advanced)

POST /email-advanced/{email}

Crea una nuova richiesta per una convalida avanzata dell'email, inclusi punteggio frode, deliverability e reputazione. Il body 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 la callback.

Convalida url (advanced)

POST /url-advanced/{url}

Crea una nuova richiesta per scansionare un URL alla ricerca di phishing, malware e altre minacce, e valutarne il punteggio di rischio. Il body 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 la callback.

Convalida ip (advanced)

POST /ip-advanced/{ip}

Crea una nuova richiesta per analizzare un indirizzo IP per connessioni proxy, VPN o TOR, e valutarne il punteggio frode e la reputazione. Il body 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 la callback.

Verifica Identità (start)

POST /idv-flash-start

Crea una nuova richiesta per eseguire una Verifica dell'Identità. Il body 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 minuti). L'intero processo è verificato dall'IA. Controlla lo stato manualmente usando GET /idv-flash-start/{id} o attendi la callback.

Verifica Identità (advanced)

POST /idv-flash-advanced

Crea una nuova richiesta per eseguire una Verifica dell'Identità. Il body 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 minuti). L'intero processo è verificato dall'IA e include anche l'acquisizione del volto. Controlla lo stato manualmente usando GET /idv-flash-advanced/{id} o attendi la callback.

Verifica Identità (expert)

POST /idv-expert

Crea una nuova richiesta per eseguire una Verifica dell'Identità. Il body 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 validato da un esperto. Controlla lo stato manualmente usando GET /idv-expert/{id} o attendi la callback.

Recupera una richiesta di convalida

GET /mobile-start/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato"

GET /email-start/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato"

GET /mobile-advanced/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato"

GET /email-advanced/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato"

GET /url-advanced/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato"

GET /ip-advanced/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato"

GET /idv-flash-start/{id}
Restituisce i dettagli di una richiesta per controllarne lo "stato". Puoi anche aggiungere uno tra "front" o "back" come parametro aggiuntivo (es. GET /idv-flash-start/{id}/front) per recuperare rispettivamente l'immagine del fronte o del retro del documento, oppure 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 i dettagli di una richiesta per controllarne lo "stato". Puoi anche aggiungere uno tra "front", "back" o "face" come parametro aggiuntivo (es. GET /idv-flash-advanced/{id}/face) per recuperare rispettivamente l'immagine del fronte del documento, del retro o del volto acquisito durante il processo, oppure 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 i dettagli di una richiesta per controllarne lo "stato". Puoi anche aggiungere uno tra "front", "back" o "face" come parametro aggiuntivo (es. GET /idv-expert/{id}/back) per recuperare rispettivamente l'immagine del fronte del documento, del retro o del volto acquisito durante il processo, oppure 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.

Oas file url trust.openapi.json
Fork or import with Postman
Production domain trust.openapi.com
Sandbox domain test.trust.openapi.com
Production Scopes 20

Rate Limits: 10000 req/min
Sandbox Scopes 21
- GET test.trust.openapi.com/email-advanced
- GET test.trust.openapi.com/email-start
- GET test.trust.openapi.com/idv-certified
- GET test.trust.openapi.com/idv-certified
- GET test.trust.openapi.com/idv-expert
- GET test.trust.openapi.com/idv-flash-advanced
- GET test.trust.openapi.com/idv-flash-start
- GET test.trust.openapi.com/ip-advanced
- GET test.trust.openapi.com/mobile-advanced
- GET test.trust.openapi.com/mobile-start
- GET test.trust.openapi.com/url-advanced
- POST test.trust.openapi.com/email-advanced
- POST test.trust.openapi.com/email-start
- POST test.trust.openapi.com/idv-certified
- POST test.trust.openapi.com/idv-expert
- POST test.trust.openapi.com/idv-flash-advanced
- POST test.trust.openapi.com/idv-flash-start
- POST test.trust.openapi.com/ip-advanced
- POST test.trust.openapi.com/mobile-advanced
- POST test.trust.openapi.com/mobile-start
- POST test.trust.openapi.com/url-advanced

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

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": {
- "isPossible": true,
- "isValid": true,
- "regionCode": "IT",
- "isValidNumberForRegion": true,
- "numberType": "MOBILE",
- "requestedNumber": "00393332114774",
- "formattedNumber": "+393332114774",
- "createdAt": "2024-09-06T13:56:19+00:00",
- "updatedAt": "2024-09-06T13:56:19+00:00",
- "state": "DONE",
- "network": "MNO - Vodafone Italy",
- "originalNetwork": "MNO - TIM (Telecom Italia SpA)",
- "roaming": false,
- "ported": true,
- "country": "Italy",
- "countryPrefix": "39",
- "details": "DELIVERED_TO_HANDSET",
- "id": "66db0a03e8ba8710290e3c0f"
},
"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

{

"callback": {
- "url": "https://your-server.site/123232",
- "custom": {
  - "myKey": "myValue"
  }
}

}

Response samples

Content type

application/json

{

"data": {
- "isPossible": true,
- "isValid": true,
- "regionCode": "IT",
- "isValidNumberForRegion": true,
- "numberType": "MOBILE",
- "requestedNumber": "00393332114474",
- "formattedNumber": "+393332114474",
- "createdAt": "2024-09-06T13:56:19+00:00",
- "updatedAt": "2024-09-06T13:56:19+00:00",
- "state": "DONE",
- "network": "MNO - Vodafone Italy",
- "originalNetwork": "MNO - TIM (Telecom Italia SpA)",
- "roaming": false,
- "ported": true,
- "country": "Italy",
- "countryPrefix": "39",
- "details": "DELIVERED_TO_HANDSET",
- "id": "66db0a03e8ba8710290e3c0f"
},
"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

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": {
- "email": "[email protected]",
- "validSpf": false,
- "validDmarc": true,
- "spfDetails": {
  - "domain": "openapi.com",
  - "dnsServerUsed": "1.1.1.1",
  - "queriedDnsForTxt": true,
  - "selectedSpfRecord": "v=spf1 include:spf.mailtrusted.org include:emsd1.com include:mailgun.org -all",
  - "formalValidity": {
    "startsWithVspf1": true,
    "hasValidAllMechanism": false,
    "dnsMechanismLookupCount": 10,
    "maxDnsMechanismLookups": 10,
    "voidLookupCount": 0,
    "maxVoidLookups": 2,
    "hasRedirectModifier": false,
    "redirectDomain": null,
    "syntaxErrors": [
    "DNS lookup limit at 'include:_spf2.mailgun.org'."
    ],
    "warnings": [ ],
    "explanationDomain": null
    },
  - "parsedMechanisms": [
    {
    "term": "include:spf.mailtrusted.org",
    "mechanism": "include",
    "value": "spf.mailtrusted.org",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    },
    {
    "term": "include:emsd1.com",
    "mechanism": "include",
    "value": "emsd1.com",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    }
    ],
  - "allMechanismDetails": null,
  - "collectedIpAddresses": {
    "ip4": [
    "207.180.201.22",
    "207.180.222.205",
    "207.180.226.204",
    "etc"
    ],
    "ip6": [
    "2001:4860:4000::/36",
    "2404:6800:4000::/36",
    "etc"
    ],
    "fromA": [ ],
    "fromMx": [ ]
    },
  - "summary": {
    "totalDnsMechanismLookupsUsed": 10,
    "finalProcessingResult": "PERMERROR",
    "evaluationLog": [ ]
    }
  },
- "dmarcDetails": {
  - "recordFound": true,
  - "record": "v=DMARC1; p=none",
  - "dnsQueryDomain": "_dmarc.openapi.com",
  - "dnsServerUsed": "8.8.8.8",
  - "policy": "none",
  - "subdomainPolicy": null,
  - "alignmentDkim": "r",
  - "alignmentSpf": "r",
  - "percentage": 100,
  - "reportingUrisAggregate": [ ],
  - "reportingUrisFailure": [ ],
  - "failureOptions": [ ],
  - "errors": [ ],
  - "warnings": [ ]
  },
- "requestedEmail": "[email protected]",
- "createdAt": "2025-05-27T12:58:39+00:00",
- "updatedAt": "2025-05-27T12:58:40+00:00",
- "state": "NEW",
- "id": "6835b6fff6722090d00e74fb"
},
"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

required

string <email>

Example: [email protected]

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

{

"callback": {
- "url": "https://your-server.site/email-callback",
- "custom": {
  - "orderId": "email-check-456"
  }
}

}

Response samples

Content type

application/json

{

"data": {
- "email": "[email protected]",
- "validSpf": false,
- "validDmarc": true,
- "spfDetails": {
  - "domain": "openapi.com",
  - "dnsServerUsed": "1.1.1.1",
  - "queriedDnsForTxt": true,
  - "selectedSpfRecord": "v=spf1 include:spf.mailtrusted.org include:emsd1.com include:mailgun.org -all",
  - "formalValidity": {
    "startsWithVspf1": true,
    "hasValidAllMechanism": false,
    "dnsMechanismLookupCount": 10,
    "maxDnsMechanismLookups": 10,
    "voidLookupCount": 0,
    "maxVoidLookups": 2,
    "hasRedirectModifier": false,
    "redirectDomain": null,
    "syntaxErrors": [
    "DNS lookup limit at 'include:_spf2.mailgun.org'."
    ],
    "warnings": [ ],
    "explanationDomain": null
    },
  - "parsedMechanisms": [
    {
    "term": "include:spf.mailtrusted.org",
    "mechanism": "include",
    "value": "spf.mailtrusted.org",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    },
    {
    "term": "include:emsd1.com",
    "mechanism": "include",
    "value": "emsd1.com",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    }
    ],
  - "allMechanismDetails": null,
  - "collectedIpAddresses": {
    "ip4": [
    "207.180.201.22",
    "207.180.222.205",
    "207.180.226.204",
    "etc"
    ],
    "ip6": [
    "2001:4860:4000::/36",
    "2404:6800:4000::/36",
    "etc"
    ],
    "fromA": [ ],
    "fromMx": [ ]
    },
  - "summary": {
    "totalDnsMechanismLookupsUsed": 10,
    "finalProcessingResult": "PERMERROR",
    "evaluationLog": [ ]
    }
  },
- "dmarcDetails": {
  - "recordFound": true,
  - "record": "v=DMARC1; p=none",
  - "dnsQueryDomain": "_dmarc.openapi.com",
  - "dnsServerUsed": "8.8.8.8",
  - "policy": "none",
  - "subdomainPolicy": null,
  - "alignmentDkim": "r",
  - "alignmentSpf": "r",
  - "percentage": 100,
  - "reportingUrisAggregate": [ ],
  - "reportingUrisFailure": [ ],
  - "failureOptions": [ ],
  - "errors": [ ],
  - "warnings": [ ]
  },
- "requestedEmail": "[email protected]",
- "createdAt": "2025-05-27T12:58:39+00:00",
- "updatedAt": "2025-05-27T12:58:40+00:00",
- "state": "NEW",
- "id": "6835b6fff6722090d00e74fb"
},
"success": true,
"message": "",
"error": null

}

Web Service Revision: 2.0.0