Saltar al contingut principal
POST
Python
Envia identificadors introduïts i atributs d’identitat declarada, selecciona les comprovacions que vols executar i revisa cada resultat per separat. Fes servir Planifica una comprovació de frau primer per revisar els requisits d’entrada i els càrrecs estimats.

Triar un perfil

Fixa profile_version perquè els valors predeterminats seleccionats i la política de decisió siguin explícits. El perfil predeterminat és standard, versió 2026-08-27. La versió 2026-09-14 afegeix l’enriquiment social opcional de correu electrònic i de telèfon, i registra cada comprovació completada com a sessió nativa de Verificació d’usuaris. En aquesta versió, els complements de pagament són d’activació voluntària. La versió 2026-09-14.1 també activa les consultes d’identificadors a la xarxa global de fraus per a les organitzacions del pla Enterprise que comparteixen globalment. La versió 2026-09-14.2 afegeix una comprovació de referència opcional entre selfie i CPF per al Brasil. Les versions anteriors mantenen el comportament original. Els perfils actuals admeten risc de correu electrònic, risc de telèfon, risc d’IP, validació en bases de dades elegibles i l’historial de la xarxa privada de la teva aplicació. La vinculació d’identitat basada en selfie requereix la versió 2026-09-14.2. Seleccionar-la en versions anteriors retorna not_available_in_profile_version.

Identitat declarada i context

Posa el correu electrònic, el telèfon i els identificadors governamentals a subject.identifiers. Els identificadors governamentals requereixen el seu país emissor; també pot caldre un emissor quan els números només són únics dins d’una regió. Posa els noms, la data de naixement, la nacionalitat i l’adreça a subject.attributes. Són declaracions per comparar quan una font seleccionada les admet, no fets verificats només pel fet d’haver-se enviat. Fes servir context per a l’adreça IP de l’intent, l’agent d’usuari, la finalitat, el país i qualsevol afirmació de consentiment requerida. Això separa la informació sobre l’intent de verificació de la informació sobre la persona. Per a les comprovacions biomètriques admeses, proporciona subject.selfie com a JPEG, PNG o WebP codificat en base64, de fins a 6 MB. També s’accepta un URI de dades d’imatge corresponent. No enviïs una imatge de referència, una URL remota ni una clau d’emmagatzematge.

Selfie i identificador declarat

Selecciona biometric_identity, envia un identificador tax_number brasiler i una selfie, i confirma context.consent_obtained. La referència comprova si aquesta selfie pertany al titular del CPF declarat. Si falta el consentiment, es retorna consent_required, i els països no admesos retornen unsupported_region. El mòdul té un preu per comprovació basat en la tarifa de Validació en bases de dades de la teva organització; revisa el pla abans d’executar-lo. Quan la referència respon, identity_relationship.result és match, mismatch o inconclusive. Una resposta no concloent requereix revisió i mai es tracta com a discrepància. El resultat només estableix la relació entre la selfie i el CPF. No valida un nom ni una data de naixement enviats, no demostra que s’hagi superat la prova de vida, ni cerca una cara a internet ni a la xarxa global de fraus. Els noms i la data de naixement continuen sent declaracions, tret que una altra font seleccionada aporti evidències per a aquests camps. Els temps d’espera esgotats i els errors de font són resultats no disponibles i no es facturen. Les respostes no concloents completades es facturen a la mateixa tarifa de comprovació de referència. Aquesta comprovació no inclou la selfie en el resultat ni la desa com a contingut multimèdia de la sessió.

Seleccionar comprovacions

checks.include selecciona els mòduls, i checks.exclude té prioritat. Una llista include explícitament buida desactiva totes les tasques opcionals; la normalització s’executa igualment. Si omets include, s’usen els valors predeterminats del perfil fixat. L’enriquiment social de correu electrònic i de telèfon se selecciona per separat amb email_social i phone_social. Requereixen un identificador vàlid i coincident, i no envien cap OTP.

Llegir els resultats sense confondre’ls

Cada mòdul informa del seu estat d’execució, del motiu i de les unitats facturables. not_requested, excluded_by_caller, missing_required_input i source_unavailable descriuen resultats diferents. Una font absent no és una discrepància d’identitat ni un resultat de risc zero. attribute_evidence descriu les evidències a nivell de camp, mentre que risk manté separades les dimensions d’identitat, contacte, dispositiu, comportament i xarxa de fraus. Un correu electrònic compartit, un dispositiu compartit o un altre identificador compartit és una connexió observada, no una prova que dos comptes pertanyin a la mateixa persona ni que hagin comès frau. recommendation és la recomanació de la comprovació; no canvia l’estat d’un altre registre. Els resultats de l’enriquiment social apareixen sota enrichment, amb els resultats no disponibles diferenciats dels completats.

Xarxa global contra el frau

Selecciona networks_cross_org per consultar els identificadors compatibles de correu electrònic, de telèfon i de document amb un espai de noms correcte a la xarxa compartida. La consulta requereix el pla Enterprise i que el mode de compartició de la teva organització estigui configurat a global. Si no es compleix alguna d’aquestes condicions, el pla informa del mòdul amb available: false i availability_reason: "entitlement_required", i una comprovació que el selecciona l’omet amb l’estat skipped i el motiu entitlement_required. El mateix motiu s’aplica quan Networks no està habilitat per a la teva organització. Les aplicacions de sandbox no estan sotmeses al pla ni al mode de compartició: amb un identificador compatible, el mòdul s’executa i retorna un resultat de mostra buit. La consulta utilitza el pressupost de lectures existent de l’organització i en deixa un registre d’auditoria. No té cap cobrament per consulta. Planificar una comprovació no consulta l’índex compartit ni consumeix el seu pressupost de lectures. network.cross_organization conté signals_checked i les insights agregades divulgades quan la comprovació finalitza. Cada element conté el tipus de senyal, les classes de resultat, el nombre de contribuidors, la franja de recència i, només si la divulgació està habilitada, les categories de sector. Mai no identifica una altra organització, un altre compte, una altra persona ni una altra verificació. Els resultats per sota del llindar de divulgació s’ometen; una llista buida no demostra l’absència d’historial de frau. Un senyal compartit divulgat activa una recomanació de revisió, mai un rebuig automàtic ni una coincidència d’identitat. Una consulta no disponible informa del seu motiu per separat d’una consulta completada buida. Si la teva organització perd més endavant l’accés a la xarxa entre organitzacions, per exemple després d’un canvi de pla o quan la compartició ja no és global, la recuperació del resultat, els reintents i els detalls de la sessió amaguen les agregacions compartides i les evidències de risc derivades. La recomanació original es manté com a decisió històrica; les lectures no canvien l’estat de la verificació.

Sessions, reintents i cobraments

check_id recupera el resultat emmagatzemat mitjançant Obté una comprovació de frau. Quan hi és, request_id identifica la seva sessió de verificació nativa. Les versions 2026-09-14, 2026-09-14.1 i 2026-09-14.2 sempre creen aquesta sessió, fins i tot quan només se selecciona l’historial de xarxa privada. Reutilitzar client_reference amb el mateix cos de sol·licitud retorna el resultat original sense una altra execució ni cobrament mentre la comprovació existeixi. Un cos diferent amb la mateixa referència retorna 409. Si l’execució encara està en curs, torna a enviar la mateixa sol·licitud després de l’interval indicat a Retry-After de la resposta. Si se suprimeix la verificació associada, també se suprimeix el resultat de la comprovació de frau; la recuperació retorna 404. Una comprovació suprimida durant l’execució no pot publicar un resultat completat. Els preus provenen de les tarifes prepagades o de contracte vigents de la teva organització. Els mòduls no disponibles i omesos no es cobren, i l’historial de xarxa privada no té cap cobrament per comprovació. Les comprovacions de sandbox utilitzen respostes de mostra sense crides de pagament a proveïdors ni cobraments.

Autoritzacions

x-api-key
string
header
requerit

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

subject
object
requerit
client_reference
string

La teva pròpia referència per a aquesta comprovació. Actua també com a clau d'idempotència: reutilitzar-la amb el mateix cos retorna la comprovació original sense tornar a executar ni facturar els mòduls; reutilitzar-la amb un cos diferent retorna un 409.

Required string length: 1 - 255
profile
string
predeterminat:standard

ID del perfil d'orquestració. Per defecte és el perfil standard de Didit.

Required string length: 1 - 64
profile_version
string

Fixa una versió de perfil congelada. Per defecte s'utilitza la versió actual del perfil.

Required string length: 1 - 32
context
object
checks
object
vendor_data
string
Maximum string length: 1000
metadata
any

Resposta

check_id
string<uuid>
requerit
client_reference
string | null
requerit
processing_status
enum<string>
requerit
  • pending - Pendent
  • running - En execució
  • completed - Completat
  • failed - Fallit
Opcions disponibles:
pending,
running,
completed,
failed
profile_id
string
requerit
profile_version
string
requerit
created_at
string<date-time>
requerit
completed_at
string<date-time> | null
requerit
inputs
object[]
requerit
modules
object[]
requerit
attribute_evidence
object[]
requerit
compound_evidence
object[]
requerit
risk
object[]
requerit
network
object
requerit
recommendation
enum<string>
requerit
  • approve - Aprovar
  • review - Revisar
  • reject - Rebutjar
Opcions disponibles:
approve,
review,
reject
next_action
enum<string>
requerit
  • none - Cap
  • manual_review - Revisió manual
  • step_up - Verificació addicional
  • resubmit_capture - Tornar a enviar captura
Opcions disponibles:
none,
manual_review,
step_up,
resubmit_capture
decision_reasons
string[]
requerit
coverage
object
requerit
usage
object[]
requerit
request_id
string<uuid>

Sessió de verificació nativa creada per a aquesta comprovació.

enrichment
object
identity_relationship
object | null
vendor_data
string | null
metadata
unknown
Darrera modificació el 7 de novembre del 2026