Saltar al contingut principal
POST
curl
Utilitza POST /v3/ip/risk/ quan el teu backend ja tingui una adreça IP i necessiti una decisió de risc de servidor a servidor. La resposta inclou la geolocalització, la titularitat de la xarxa, els indicadors de VPN/Tor i de centre de dades, les dades d’amenaça i country_mismatch quan envies un país declarat.

Interpretar la resposta

  • status és In Review quan el país resolt entra en conflicte amb claimed_country, o quan l’adreça està associada a infraestructura de VPN, Tor o centre de dades. En cas contrari, és Approved.
  • ip.ip_country_code conté el codi del país resolt. Compara els països a través de ip.country_mismatch en lloc de comparar tu mateix les cadenes de país sense processar.
  • ip.latitude i ip.longitude són una geolocalització de xarxa aproximada, no una ubicació precisa del dispositiu.
  • ip.is_vpn_or_tor, ip.is_data_center, ip.proxy_type i ip.threat aporten evidència de risc de xarxa.
  • ip.asn_number, ip.asn_organization, ip.connection_type i ip.carrier descriuen la xarxa a la qual pertany l’adreça.
  • request_id és l’identificador de la sessió de l’API. Emmagatzema’l amb vendor_data si necessites correlacionar el resultat amb webhooks posteriors o amb l’activitat de la consola.
L’enriquiment d’IP es fa tan bé com es pot. Si cap font d’enriquiment retorna dades utilitzables, l’endpoint retorna una resposta aprovada amb ip.ip_address: null, ip.country_mismatch: null i un objecte ip.threat buit. Els camps d’enriquiment individuals també poden ser null quan no estiguin disponibles.

Intel·ligència del dispositiu

L’API de risc d’IP és un endpoint pur de servidor a servidor. La identificació del dispositiu (empremta digital del dispositiu) tampoc no és exclusivament de servidor a servidor, perquè un backend no pot observar per si mateix els senyals del navegador o del dispositiu. Per a les sessions del flux allotjat i del SDK, Didit exposa els camps del dispositiu ja recollits a la resposta de la sessió, inclosos device_fingerprint, els detalls del dispositiu i del navegador, user_agent, les dades del dispositiu en brut i les coincidències entre sessions.

Comportament del sandbox

Les claus de sandbox validen la sol·licitud i retornen dades aprovades deterministes. No contacten amb serveis externs d’intel·ligència, no consumeixen crèdits, no creen una sessió i no contribueixen a Networks.

Facturació

Les crides a l’API de risc d’IP costen $0.02 al preu de llista. Una sol·licitud de producció es factura en el moment en què comença la consulta.

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

application/json
ip_address
string<ip>
requerit

Adreça IPv4 o IPv6 a puntuar.

Exemple:

"8.8.8.8"

claimed_country
string

País ISO 3166-1 alfa-2 o alfa-3 opcional declarat per l'usuari o la sessió. S'utilitza per calcular country_mismatch.

Maximum string length: 3
Exemple:

"ESP"

user_agent
string

Agent d'usuari observat pel teu back-end. S'emmagatzema com a context de la sol·licitud; no proporciona empremta digital del dispositiu.

Maximum string length: 512
vendor_data
string

La teva referència estable per a aquesta sol·licitud. S'emmagatzema a la sessió de l'API i es retorna a la resposta.

metadata
object | null

Les teves metadades JSON no sensibles. S'emmagatzemen a la sessió de l'API i es retornen a la resposta.

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.

request_id
string<uuid>
requerit

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.

status
enum<string>
requerit

Decisió per a aquesta sessió de l'API: In Review per risc de xarxa o discrepància de país, en cas contrari Approved.

Opcions disponibles:
Approved,
In Review
created_at
string<date-time>
requerit

Marca de temps d'aquesta resposta.

vendor_data
string | null

Ressò de les vendor_data que has enviat, null si no n'has enviat cap.

metadata
object | null

Ressò de les metadata que has enviat, null si no n'has enviat cap.

ip
object

Resultat de risc d'IP. Els camps d'enriquiment individuals poden ser null quan la cerca no ha retornat dades utilitzables.

Darrera modificació el 7 de novembre del 2026