Confiance

Confiance 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.

Conseils utiles pour commencer Confiance

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.

API de Confiance

Utilisez les points de terminaison suivants pour valider les numéros de téléphone ou les adresses e-mail :

Validation du téléphone

POST /mobile-start/{numero-de-telephone}

Créez une nouvelle demande ; le corps de la requête 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 recevrez un résultat partiel avec un statut "NEW" ou "WAIT". Attendez simplement une notification lorsque la recherche sera terminée. Vous pouvez également vérifier le statut manuellement en utilisant la méthode GET et l'ID fourni.

Validation de l'e-mail

POST /email-start/{email}

Créez une nouvelle demande pour valider une adresse e-mail. Le corps de la requête 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.

Récupérer une demande de validation

GET /mobile-start/{id}
Retourne les détails d'une demande pour vérifier son "état"

GET /email-start/{id}
Retourne les détails d'une demande pour vérifier son "état"

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.

HLR

requête "Home Location Register" pour la validation des numéros de téléphone mobile

Renvoyer une demande

Renvoie un détail de la demande pour vérifier l'"état"

Authorizations:
bearerAuth
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

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": ""
}

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:
bearerAuth
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

Content type
application/json
{}

Response samples

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

Email

Services de validation des courriels

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:
bearerAuth
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

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
}

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:
bearerAuth
path Parameters
email
required
string <email>

L'adresse électronique à valider.

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

Content type
application/json
{}

Response samples

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