Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl
curl -X POST https://verification.didit.me/v3/phone/risk/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"phone_number": "+14155552671",
"country_code": "US",
"vendor_data": "lead-123",
"metadata": {"source": "signup_prescreen"}
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.phone.assess_risk(
phone_number="+14155552671",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.phone.assessRisk({
phone_number: "+14155552671",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Phone.AssessRisk(ctx, didit.PhoneRiskRequest{
PhoneNumber: "+14155552671",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.PhoneRiskRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.phone().assessRisk(PhoneRiskRequest.builder()
.phoneNumber("+14155552671")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->phone->assessRisk([
'phone_number' => '+14155552671',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.phone.assess_risk(phone_number: "+14155552671")
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.AssessRiskAsync(new PhoneRiskRequest
{
PhoneNumber = "+14155552671",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "4fd09d2e-9bc9-4c4e-9c46-7f625ac0ab62",
"status": "Approved",
"phone": {
"status": "Approved",
"phone_number_prefix": "+1",
"phone_number": "4155552671",
"full_number": "+14155552671",
"country_code": "US",
"country_name": "United States",
"carrier": {
"name": "Example Mobile",
"type": "mobile"
},
"is_disposable": false,
"is_virtual": false,
"verification_method": null,
"verification_attempts": 0,
"verified_at": null,
"warnings": [],
"lifecycle": [],
"matches": [],
"phone_intelligence": {
"score": 3,
"phone_type_risk": "Low",
"phone_trust_index": 97,
"network_stability_index": 95,
"is_disposable": false,
"is_ported": false,
"is_recently_ported": false,
"carrier_type": "mobile",
"reason_codes": []
},
"enrichment": {
"score": 3,
"phone_type_risk": "Low",
"phone_trust_index": 97,
"network_stability_index": 95,
"is_disposable": false,
"is_ported": false,
"is_recently_ported": false,
"carrier_type": "mobile",
"reason_codes": []
}
},
"vendor_data": "lead-123",
"metadata": {
"source": "signup_prescreen"
},
"created_at": "2026-09-01T10:30:00.123456+00:00"
}
Verificació de telèfon
API de risc de telèfon: operador i senyals de frau
Puntua el risc d’un número de telèfon sense enviar OTP. Operador, tipus de línia, portabilitat i senyals de frau en una crida de Didit.
POST
/
v3
/
phone
/
risk
/
curl
curl -X POST https://verification.didit.me/v3/phone/risk/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"phone_number": "+14155552671",
"country_code": "US",
"vendor_data": "lead-123",
"metadata": {"source": "signup_prescreen"}
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.phone.assess_risk(
phone_number="+14155552671",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.phone.assessRisk({
phone_number: "+14155552671",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Phone.AssessRisk(ctx, didit.PhoneRiskRequest{
PhoneNumber: "+14155552671",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.PhoneRiskRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.phone().assessRisk(PhoneRiskRequest.builder()
.phoneNumber("+14155552671")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->phone->assessRisk([
'phone_number' => '+14155552671',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.phone.assess_risk(phone_number: "+14155552671")
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.AssessRiskAsync(new PhoneRiskRequest
{
PhoneNumber = "+14155552671",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "4fd09d2e-9bc9-4c4e-9c46-7f625ac0ab62",
"status": "Approved",
"phone": {
"status": "Approved",
"phone_number_prefix": "+1",
"phone_number": "4155552671",
"full_number": "+14155552671",
"country_code": "US",
"country_name": "United States",
"carrier": {
"name": "Example Mobile",
"type": "mobile"
},
"is_disposable": false,
"is_virtual": false,
"verification_method": null,
"verification_attempts": 0,
"verified_at": null,
"warnings": [],
"lifecycle": [],
"matches": [],
"phone_intelligence": {
"score": 3,
"phone_type_risk": "Low",
"phone_trust_index": 97,
"network_stability_index": 95,
"is_disposable": false,
"is_ported": false,
"is_recently_ported": false,
"carrier_type": "mobile",
"reason_codes": []
},
"enrichment": {
"score": 3,
"phone_type_risk": "Low",
"phone_trust_index": 97,
"network_stability_index": 95,
"is_disposable": false,
"is_ported": false,
"is_recently_ported": false,
"carrier_type": "mobile",
"reason_codes": []
}
},
"vendor_data": "lead-123",
"metadata": {
"source": "signup_prescreen"
},
"created_at": "2026-09-01T10:30:00.123456+00:00"
}Utilitza
POST /v3/phone/risk/ quan necessitis intel·ligència sobre el telèfon abans, en lloc de, o fora d’un flux OTP.
No envia cap codi a l’usuari. Crea una sessió d’API, enriqueix el número, aplica les regles de risc de telèfon i retorna, en una única resposta síncrona, el mateix bloc de telèfon normalitzat que utilitza la Verificació de telèfon.
Quan la sol·licitud es desa, Didit també pot utilitzar el número de telèfon puntuat com a evidència agregada a Xarxes. Els grafs de xarxa poden mostrar intel·ligència telefònica d’alt risc, i context de portabilitat i de tipus de línia sobre senyals de telèfon compartits, però no revelen el número de telèfon original a altres organitzacions.
Interpreta la resposta
statusés la decisió final d’aquesta sessió d’API. Normalment ésApproved; l’avaluació de risc pot produirIn ReviewoDeclined.phone.full_numberés el número normalitzat en E.164.phone.phone_number_prefixiphone.phone_numberel separen en el prefix internacional i el número nacional.phone.is_disposableiphone.is_virtualsón els senyals estables de sí/no per a la lògica de l’aplicació. La consulta d’operador afegeixcarrier.nameicarrier.type(mobile,voipi similars).phone.phone_intelligence.scoreutilitza una escala de risc de 0-100, on un número més alt indica un risc més alt.phone_type_risk(Low,Medium,High) iphone_trust_index(l’invers de la puntuació) són vistes derivades.phone.phone_intelligenceiphone.enrichmentsón àlies de compatibilitat amb el mateix objecte normalitzat. Les integracions noves poden llegirphone.enrichment.phone.matchesenumera altres sessions de la vostra aplicació en què el mateix número va ser utilitzat per un usuari diferent. Utilitzeu-ho per detectar comptes duplicats.request_idés l’identificador de la sessió d’API. Desa’l ambvendor_datasi necessites correlacionar el resultat amb webhooks posteriors o amb l’activitat de la consola.
phone.phone_intelligence i phone.enrichment són camps subjectes a disponibilitat. Una consulta completada pot no incloure cap dels dos quan no es retorna cap dada d’intel·ligència utilitzable per a aquest número, país o pla. Construeix les regles primer sobre els camps normalitzats estables i tracta la intel·ligència que falta com a “desconeguda”, no com a “segura”.Complement de petjada social
Estableixenable_social a true per afegir un bloc phone_social a la resposta, dins de phone: les plataformes en línia on aquest número de telèfon està registrat, agrupades per categoria, amb els recomptes del resum i els detalls de perfil que retornen els nostres socis de dades.
phone.phone_social.profiles_registerediphone.phone_social.profiles_checkedsón les xifres principals: les plataformes on el número de telèfon consta com a registrat, sobre el total de plataformes avaluades.phone.phone_social.registered_platformsiphone.phone_social.not_registered_platformsenumeren cada plataforma amb la sevacategoryi el seuscope(global, olocalper a plataformes específiques de cada regió).phone.phone_social.categoriesindica el recompte i la proporció de registres per categoria, iphone.phone_social.profilesconté els detalls de perfil per plataforma quan una plataforma els exposa (nom, URL de la foto, text de presentació, estat de privacitat, indicador de compte empresarial).- Els índexs resum (
digital_footprint_diversity,digital_sophistication_index,engagement_depth_index,subscription_affordability_index) són índexs compostos amb valors de 0 a 10. Qualsevol recompte pot sernullquan la comprovació no ha retornat dades per a aquest recompte.
profiles_registered: 0 és una resposta real, no un error: les plataformes es van comprovar i el número de telèfon no es va trobar en cap d’elles, cosa que és un senyal habitual d’identitat sintètica. Aquest endpoint no actua per si sol sobre aquest resultat; utilitza phone_no_social_presence_action en un flux de treball per convertir-lo en un veredicte de revisió o de rebuig.
El bloc no apareix quan enable_social no està establert, ni tampoc quan la comprovació de xarxes socials no es va poder completar; en aquest cas no es factura.
Comportament del sandbox
Les claus de sandbox validen la sol·licitud i retornen dades deterministes amb resultat aprovat. No envien cap OTP, no consumeixen crèdits, no creen cap sessió ni contribueixen a Xarxes. Ambenable_social establert, també retornen un bloc phone_social determinista.
Facturació
Les crides a la Phone Risk API costen $0.04 al preu de llista, menys que una Verificació de telèfon completa, perquè no s’envia cap OTP. Una sol·licitud en directe és facturable en el moment que s’inicia la consulta, fins i tot quan alguns camps subjectes a disponibilitat no estan disponibles. El complement de petjada social es factura per separat: una unitatphone_social per sol·licitud, a més del preu de la Phone Risk API, sempre que la comprovació es completi. La verificació de crèdit prèvia a la consulta cobreix tots dos conceptes.Autoritzacions
La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.
Cos
application/json
Número de telèfon a puntuar. Es valida i es normalitza a E.164.
Maximum string length:
20Exemple:
"+14155552671"
Indicació opcional de país ISO 3166-1 alfa-2 o alfa-3 per a la cobertura d'intel·ligència.
Maximum string length:
3Exemple:
"US"
Context opcional de dispositiu i xarxa observat per la teva aplicació. Tots els camps són opcionals. Enviar-los alimenta la detecció de coincidències entre sessions a Networks.
Show child attributes
Show child attributes
La teva referència estable per a aquesta sol·licitud. S'emmagatzema a la sessió de l'API i es retorna a la resposta.
Les teves metadades JSON no sensibles. S'emmagatzemen a la sessió de l'API i es retornen a la resposta.
Quan és cert, també consulta la petjada social del número: les plataformes de missatgeria, socials, de comerç electrònic i professionals on està registrat. Es factura com una unitat de phone_social per sol·licitud a més del preu propi d'aquest endpoint.
Exemple:
true
Resposta
S'ha completat l'avaluació de risc. Inspecciona status per conèixer la decisió; la resposta HTTP sempre és 200 per a consultes completades.
Identificador de la sessió d'API creada per a aquesta sol·licitud. Emmagatzema'l amb vendor_data si necessites correlacionar el resultat amb webhooks posteriors o amb l'activitat a la consola.
Decisió final per a aquesta sessió d'API. Normalment Approved; l'avaluació de risc pot generar In Review o Declined.
Opcions disponibles:
Approved, In Review, Declined Marca de temps d'aquesta resposta.
Ressò de les vendor_data que has enviat, null si no n'has enviat cap.
Ressò de les metadata que has enviat, null si no n'has enviat cap.
Informe normalitzat de telèfon, el mateix bloc utilitzat per les respostes de Verificació de telèfon.
Show child attributes
Show child attributes
Darrera modificació el 7 de novembre del 2026