Commencer
Intégrer / SDK
Vérification des utilisateurs
Vérification d'entreprise
Surveillance des transactions
Journal des modificationscurl -X POST https://verification.didit.me/v3/phone/check/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"phone_number": "+14155552671",
"code": "123456",
"voip_number_action": "DECLINE"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.phone.check_code(
phone_number="+14155552671",
code="123456",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.phone.checkCode({
phone_number: "+14155552671",
code: "123456",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Phone.CheckCode(ctx, didit.PhoneCheckCodeParams{
PhoneNumber: "+14155552671",
Code: "123456",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.PhoneCheckCodeParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.phone().checkCode(PhoneCheckCodeParams.builder()
.phoneNumber("+14155552671")
.code("123456")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->phone->checkCode([
'phone_number' => '+14155552671',
'code' => '123456',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.phone.check_code(
phone_number: "+14155552671",
code: "123456"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Phone.CheckCodeAsync(new PhoneCheckCodeParams
{
PhoneNumber = "+14155552671",
Code = "123456",
});
Console.WriteLine(JsonSerializer.Serialize(result));API de vérification de code SMS : valider un OTP
Didit : validez un code OTP SMS via POST /v3/phone/check/. Détection de l’opérateur, des numéros virtuels et jetables. Paiement à l’usage.
curl -X POST https://verification.didit.me/v3/phone/check/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"phone_number": "+14155552671",
"code": "123456",
"voip_number_action": "DECLINE"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.phone.check_code(
phone_number="+14155552671",
code="123456",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.phone.checkCode({
phone_number: "+14155552671",
code: "123456",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Phone.CheckCode(ctx, didit.PhoneCheckCodeParams{
PhoneNumber: "+14155552671",
Code: "123456",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.PhoneCheckCodeParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.phone().checkCode(PhoneCheckCodeParams.builder()
.phoneNumber("+14155552671")
.code("123456")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->phone->checkCode([
'phone_number' => '+14155552671',
'code' => '123456',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.phone.check_code(
phone_number: "+14155552671",
code: "123456"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Phone.CheckCodeAsync(new PhoneCheckCodeParams
{
PhoneNumber = "+14155552671",
Code = "123456",
});
Console.WriteLine(JsonSerializer.Serialize(result));Gérer les pannes du fournisseur
Si le fournisseur téléphonique est temporairement indisponible, cet endpoint renvoie502 avec un code stable lisible par machine :
{
"detail": "The phone verification provider is temporarily unavailable.",
"code": "phone_provider_unavailable"
}
Module complémentaire d’intelligence
Définissezenable_enrichment sur true pour lancer également une analyse intelligente du numéro de téléphone : un score de risque, le type de ligne, si le numéro a été récemment porté et un indice de confiance.
Le module complémentaire est facturé $0.05 par requête au tarif public, en plus du prix de la vérification.
La requête renvoie 403 lorsque votre solde ne suffit pas à le couvrir.
Quatre champs déterminent l’effet des signaux.
Chacun prend la valeur NO_ACTION (par défaut) ou DECLINE, et chacun ne s’applique que lorsque enable_enrichment est true.
| Champ | Refus lorsque |
|---|---|
phone_intelligence_score_action | Le score de risque est supérieur au seuil. |
phone_type_risk_action | Le numéro correspond à un type de ligne à haut risque. |
recent_port_action | Le numéro a été porté récemment vers un autre opérateur. |
low_phone_trust_action | L’indice de confiance est inférieur ou égal au seuil. |
NO_ACTION, le signal est tout de même renvoyé dans phone.phone_intelligence, afin que vous puissiez appliquer votre propre règle.Autorisations
La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.
Corps
Le même numéro de téléphone que celui utilisé dans l'appel POST /v3/phone/send/ correspondant, au format E.164. C'est ce qui associe la vérification à l'envoi.
20"+14155552671"
L'OTP reçu par l'utilisateur final. Doit comporter entre 4 et 8 chiffres numériques — toute autre valeur renvoie 400 sans décompter de tentative. Un code bien formé mais incorrect renvoie 200 avec status: "Failed" et décompte l'une des 3 tentatives.
4 - 8^[0-9]{4,8}$"123456"
Que faire lorsque le même numéro a déjà été utilisé par un autre utilisateur (vendor_data différent) de votre application. DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le risque dans phone.warnings et renseigne phone.matches.
NO_ACTION, DECLINE Ce qu'il faut faire lorsque la recherche d'opérateur signale le numéro comme une ligne temporaire ou jetable (phone.is_disposable). DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le risque dans phone.warnings.
NO_ACTION, DECLINE Ce qu'il faut faire lorsque la recherche d'opérateur indique un type de ligne virtuelle — voip, isp ou vpn (phone.is_virtual). DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le risque dans phone.warnings.
NO_ACTION, DECLINE Lorsque la valeur est true, exécute également une analyse de renseignements téléphoniques sur le numéro : un score de risque, le type de ligne, un éventuel portage récent et un indice de confiance. Facturé comme une unité phone_intelligence_api par requête ($0.05 au prix catalogue) en plus du prix propre à cet endpoint. La requête renvoie 403 lorsque votre solde ne permet pas de la couvrir.
false
Action lorsque le score de risque de l'intelligence téléphonique est supérieur au seuil. DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le signal sans refuser. Ne prend effet que lorsque enable_enrichment est true.
NO_ACTION, DECLINE Action lorsque le numéro correspond à un type de ligne à haut risque. DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le signal sans refuser. Ne prend effet que lorsque enable_enrichment est true.
NO_ACTION, DECLINE Action lorsque le numéro a été récemment porté vers un autre opérateur. DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le signal sans refuser. Ne prend effet que lorsque enable_enrichment est true.
NO_ACTION, DECLINE Action lorsque l'indice de confiance de l'intelligence téléphonique est inférieur ou égal au seuil. DECLINE fait passer le status final à Declined ; NO_ACTION enregistre le signal sans refuser. Ne prend effet que lorsque enable_enrichment est true.
NO_ACTION, DECLINE Si true, recherche également l'empreinte sociale du numéro : les plateformes de messagerie, sociales, d'e-commerce et professionnelles sur lesquelles il est enregistré. Facturé comme une unité phone_social par requête en plus du prix propre de cet endpoint.
true
Action lorsque la vérification de l'empreinte sociale ne trouve le numéro enregistré sur aucune des plateformes couvertes. Seuls NO_ACTION et DECLINE sont acceptés sur cet endpoint ; REVIEW est disponible sur la clé de configuration du workflow du même nom.
NO_ACTION, DECLINE Réponse
Vérification terminée — les codes erronés et les vérifications manquantes renvoient également 200 ; inspectez status, et non le code HTTP. phone n'est renseigné que pour les résultats finalisés (Approved/Declined), vaut null pour Failed, et est absent pour Expired or Not Found.
Pour Approved/Declined : l'identifiant de session de la vérification correspondante — identique au request_id renvoyé par POST /v3/phone/send/. Pour Failed et Expired or Not Found : un UUID aléatoire à usage unique qui ne pourra pas être consulté ultérieurement.
Approved — code correct, aucun risque de refus. Declined — définitif : un risque entraînant un refus a correspondu ou le nombre maximal de tentatives (3) a été épuisé. Failed — code erroné, tentatives restantes. Expired or Not Found — aucune vérification en attente pour ce numéro au cours des 5 dernières minutes.
Approved, Declined, Failed, Expired or Not Found Explication lisible par l'humain du résultat, incluant le nombre de tentatives restantes après un code erroné.
Rapport téléphonique complet. Présent (non nul) uniquement pour les résultats finalisés (Approved/Declined) ; null en cas de Failed et absent en cas de Expired or Not Found.
Show child attributes
Show child attributes
vendor_data de la session de la vérification correspondante. null pour Expired or Not Found.
metadata de la session de la vérification correspondante. null pour Expired or Not Found.
Horodatage de cette réponse de vérification.