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.
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.
Prendi il token nell'apposita sezione prima di cominciare.
API Trust
Convalida telefono
POST /mobile-start/{mobile-phone-number}Crea una nuova richiesta; il corpo del post viene utilizzato per specificare i parametri di "callback". Il sistema avvierà una ricerca HLR globale sul numero di telefono specificato.
Alcuni operatori di telefonia mobile e la congestione della rete possono rallentare la richiesta.
Se la ricerca richiede più di 10 secondi, riceverai un risultato parziale con stato "NEW" or "WAIT". Attendi una notifica al termine della ricerca. Puoi anche controllare lo stato manualmente utilizzando il metodo GET e l'ID fornito.
Convalida email
POST /email-start/{email}Crea una nuova richiesta per convalidare un indirizzo email. Il corpo può specificare i parametri di callback. Il sistema avvierà un processo di convalida dell'email.
Se la convalida richiede più di qualche secondo, potresti ricevere un risultato parziale con stato 'NEW' or 'WAIT'. Controlla lo stato manualmente usando GET /email-start/{id} o attendi il callback.
Convalida telefono (avanzata)
POST /mobile-advanced/{mobile-phone-number}Crea una nuova richiesta per una convalida avanzata del numero di telefono, includendo punteggio di frode, operatore, tipo di linea e altro. Se la convalida richiede più di qualche secondo, potresti ricevere un risultato parziale con stato 'NEW' or 'WAIT'. Controlla lo stato manualmente usando GET /mobile-advanced/{id} o attendi il callback.
Convalida email (avanzata)
POST /email-advanced/{email}Crea una nuova richiesta per una convalida avanzata dell'email, includendo punteggio di frode, deliverability e reputazione. Se la convalida richiede più di qualche secondo, potresti ricevere un risultato parziale con stato 'NEW' or '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 valutarne il punteggio di rischio. Se la convalida richiede più di qualche secondo, potresti ricevere un risultato parziale con stato 'NEW' or '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 valutarne il punteggio di frode e la reputazione. Se la convalida richiede più di qualche secondo, potresti ricevere un risultato parziale con stato 'NEW' or 'WAIT'. Controlla lo stato manualmente usando GET /ip-advanced/{id} o attendi il callback.
Recupera una richiesta di convalida
GET /mobile-start/{id}Restituisce il dettaglio di una richiesta per controllarne lo "stato"
GET /email-start/{id}
Restituisce il dettaglio di una richiesta per controllarne lo "stato"
GET /mobile-advanced/{id}
Restituisce il dettaglio di una richiesta per controllarne lo "stato"
GET /email-advanced/{id}
Restituisce il dettaglio di una richiesta per controllarne lo "stato"
GET /url-advanced/{id}
Restituisce il dettaglio di una richiesta per controllarne lo "stato"
GET /ip-advanced/{id}
Restituisce il dettaglio di una richiesta per controllarne lo "stato"
- Oas file url https://console.openapi.com/oas/it/trust.openapi.json
- Fork or import with Postman
- Production domain trust.openapi.com
- Sandbox domain test.trust.openapi.com
-
Production Scopes 12
- POST trust.openapi.com/mobile-start
- GET trust.openapi.com/mobile-start
- GET trust.openapi.com/email-start
- POST trust.openapi.com/email-start
- GET trust.openapi.com/mobile-advanced
- GET trust.openapi.com/email-advanced
- GET trust.openapi.com/url-advanced
- GET trust.openapi.com/ip-advanced
- POST trust.openapi.com/mobile-advanced
- POST trust.openapi.com/email-advanced
- POST trust.openapi.com/url-advanced
- POST trust.openapi.com/ip-advanced
-
Sandbox Scopes 12
- POST test.trust.openapi.com/mobile-start
- GET test.trust.openapi.com/mobile-start
- POST test.trust.openapi.com/email-start
- GET test.trust.openapi.com/email-start
- GET test.trust.openapi.com/mobile-advanced
- GET test.trust.openapi.com/email-advanced
- GET test.trust.openapi.com/url-advanced
- GET test.trust.openapi.com/ip-advanced
- POST test.trust.openapi.com/mobile-advanced
- POST test.trust.openapi.com/email-advanced
- POST test.trust.openapi.com/url-advanced
- POST test.trust.openapi.com/ip-advanced
Trust (1.0.0)
Utilizzate questa API per verificare la validità e l'attendibilità di dati quali indirizzi e-mail e numeri di cellulare.
Recuperare una richiesta
Restituisce un dettaglio della richiesta per controllare lo "stato"
Authorizations:
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
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 404
- 406
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
Response samples
- 200
- 406
- "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
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:
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
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 404
- 406
- "data": {
- "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": [ ]
- "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:
path Parameters
email required |
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "callback": {
- "custom": {
- "orderId": "email-check-456"
Response samples
- 200
- 400
- 406
- "data": {
- "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": [ ]
- "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