Saltar al contenido principal
POST
Ingerir señal de riesgo

Encabezados

Respuesta

string
UUID de la señal de riesgo creada.
integer
La puntuación de riesgo ingerida (0-100).
string
Marca de tiempo de ingesta ISO 8601.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
signal_source
string
requerido
signal_type
string
requerido

Clasificación de la señal de riesgo

Ejemplo:

"velocity_anomaly"

subject_id
string
requerido
subject_type
string
requerido
idempotency_key
string
ip_address
string
payload
any
risk_score
integer
user_agent
string

Respuesta

Señal de riesgo ingerida

id
string<uuid>
tenant_id
string<uuid>
source
string

Origen de la señal (por ejemplo, device_fingerprint, ip_reputation, email_verification, document_analysis, behavioral)

Ejemplo:

"device_fingerprint"

signal_type
string

Clasificación de la señal de riesgo

Ejemplo:

"velocity_anomaly"

score
number<float>

Puntuación de riesgo entre 0 (sin riesgo) y 1 (riesgo más alto)

Rango requerido: 0 <= x <= 1
Ejemplo:

0.85

details
object

Metadatos arbitrarios asociados con la señal

Ejemplo:
entity_type
enum<string>

El tipo de entidad a la que se refiere esta señal

Opciones disponibles:
user,
device,
ip,
document,
session
Ejemplo:

"user"

entity_id
string

Identificador de la entidad que se está evaluando

Ejemplo:

"usr_8f14e45f"

created_at
string<date-time>