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.

Utili consigli per iniziare con 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.

Trust API

Utilizza i seguenti endpoint per convalidare numeri di telefono o indirizzi email:

Convalida telefono

POST /mobile-start/{numero-di-telefono}

Crea una nuova richiesta; il corpo del post è 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 uno stato "NEW" o "WAIT". Attendi una notifica quando la ricerca sarà terminata. 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 del post 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' o 'WAIT'. Controlla lo stato manualmente usando GET /email-start/{id} o attendi il 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"

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 4
Sandbox Scopes 4
- 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

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