Confiance numérique est la meilleure solution pour prévenir les actions malveillantes sur votre plateforme via des API.
Vérifiez la validité des informations de vos clients et utilisateurs en quelques secondes : du numéro de mobile à l'email et aux données personnelles.
Toutes les connaissances dont vous avez besoin
Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.
Obtenir le Token dans la section appropriée avant de commencer.
API Trust
Valider le téléphone
POST /mobile-start/{mobile-phone-number}Créez une nouvelle demande, le corps de la requête post est utilisé pour spécifier les paramètres de "callback". Le système lancera une recherche HLR globale sur le numéro de téléphone spécifié.
Certains opérateurs mobiles et la congestion du réseau peuvent ralentir la demande.
Si la recherche prend plus de 10 secondes, vous obtiendrez un résultat partiel avec le statut "NEW" ou "WAIT". Attendez simplement une notification lorsque la recherche est terminée. Vous pouvez également vérifier le statut manuellement en utilisant la méthode GET et l'ID fourni.
Valider l'e-mail
POST /email-start/{email}Créez une nouvelle demande pour valider une adresse e-mail. Le corps peut spécifier des paramètres de callback. Le système lancera un processus de validation de l'e-mail.
Si la validation prend plus de quelques secondes, vous pourriez obtenir un résultat partiel avec le statut 'NEW' ou 'WAIT'. Vérifiez le statut manuellement en utilisant GET /email-start/{id} ou attendez le callback.
Valider le téléphone (avancé)
POST /mobile-advanced/{mobile-phone-number}Créez une nouvelle demande pour une validation avancée du numéro de téléphone, incluant le score de fraude, l'opérateur, le type de ligne, et plus encore. Si la validation prend plus de quelques secondes, vous pourriez obtenir un résultat partiel avec le statut 'NEW' ou 'WAIT'. Vérifiez le statut manuellement en utilisant GET /mobile-advanced/{id} ou attendez le callback.
Valider l'e-mail (avancé)
POST /email-advanced/{email}Créez une nouvelle demande pour une validation avancée de l'e-mail, incluant le score de fraude, la délivrabilité et la réputation. Si la validation prend plus de quelques secondes, vous pourriez obtenir un résultat partiel avec le statut 'NEW' ou 'WAIT'. Vérifiez le statut manuellement en utilisant GET /email-advanced/{id} ou attendez le callback.
Valider l'URL (avancé)
POST /url-advanced/{url}Créez une nouvelle demande pour analyser une URL à la recherche de phishing, de logiciels malveillants et d'autres menaces, et évaluer son score de risque. Si la validation prend plus de quelques secondes, vous pourriez obtenir un résultat partiel avec le statut 'NEW' ou 'WAIT'. Vérifiez le statut manuellement en utilisant GET /url-advanced/{id} ou attendez le callback.
Valider l'IP (avancé)
POST /ip-advanced/{ip}Créez une nouvelle demande pour analyser une adresse IP à la recherche de connexions proxy, VPN ou TOR, et évaluer son score de fraude et sa réputation. Si la validation prend plus de quelques secondes, vous pourriez obtenir un résultat partiel avec le statut 'NEW' ou 'WAIT'. Vérifiez le statut manuellement en utilisant GET /ip-advanced/{id} ou attendez le callback.
Récupérer une demande de validation
GET /mobile-start/{id}Retourne le détail d'une demande pour vérifier l'"état"
GET /email-start/{id}
Retourne le détail d'une demande pour vérifier l'"état"
GET /mobile-advanced/{id}
Retourne le détail d'une demande pour vérifier l'"état"
GET /email-advanced/{id}
Retourne le détail d'une demande pour vérifier l'"état"
GET /url-advanced/{id}
Retourne le détail d'une demande pour vérifier l'"état"
GET /ip-advanced/{id}
Retourne le détail d'une demande pour vérifier l'"état"
- Oas file url https://console.openapi.com/oas/fr/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)
Utilisez cette API pour vérifier la validité et la fiabilité de données telles que les adresses électroniques et les numéros de téléphone mobile.
Renvoyer une demande
Renvoie un détail de la demande pour vérifier l'"état"
Authorizations:
path Parameters
id required | string Example: 66c881896de559cb65055392 identifiant de la requête obtenu par la méthode "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": ""
Créer une nouvelle demande HLR
Créer une nouvelle demande, le corps du message est utilisé pour spécifier les paramètres de "rappel". Le système lancera une recherche HLR globale sur le numéro de téléphone spécifié.
Certains opérateurs de téléphonie mobile et l'encombrement du réseau peuvent ralentir la demande. Si la recherche prend plus de 10 secondes, vous obtiendrez un résultat partiel avec le statut "NEW" ou "WAIT". Attendez simplement une notification lorsque la recherche est terminée. Vous pouvez également vérifier le statut manuellement en utilisant la méthode GET et l'identifiant fourni.
Authorizations:
path Parameters
mobile-phone-number required | string Example: +393939989747 Le téléphone portable en complément du préfixe international |
Request Body schema: application/json
object Il s'agit de notre système de rappel OpenAPI standardisé. Il permet de configurer les paramètres pour recevoir des notifications sur les mises à jour de l'état des demandes asynchrones adressées à ce point de terminaison. |
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
Récupérer une demande de validation d'un courriel
Renvoie une demande de validation par courrier électronique pour vérifier l'état et les résultats.
Authorizations:
path Parameters
id required | string Example: 77e9e92216065fa37f3c9842 ID de la requête obtenu en utilisant la méthode 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
Créer une nouvelle demande de validation d'un courriel
Créer une nouvelle requête pour valider une adresse électronique. Le corps peut spécifier des paramètres de rappel. Le système lancera un processus de validation de l'adresse électronique. Si la validation prend plus de quelques secondes, il se peut que vous obteniez un résultat partiel avec le statut "NEW" ou "WAIT". Vérifiez le statut manuellement en utilisant GET /email-start/{id} ou attendez le rappel.
Authorizations:
path Parameters
email required |
Request Body schema: application/json
object Il s'agit de notre système de rappel OpenAPI standardisé. Il permet de configurer les paramètres pour recevoir des notifications sur les mises à jour de l'état des demandes asynchrones adressées à ce point de terminaison. |
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