Passer au contenu principal
POST
Ingérer un signal de risque

En-têtes

Réponse

string
UUID du signal de risque créé.
integer
Le score de risque ingéré (0-100).
string
Horodatage d’ingestion ISO 8601.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
signal_source
string
requis
signal_type
string
requis

Classification du signal de risque

Exemple:

"velocity_anomaly"

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

Réponse

Signal de risque ingéré

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

Origine du signal (par exemple device_fingerprint, ip_reputation, email_verification, document_analysis, behavioral)

Exemple:

"device_fingerprint"

signal_type
string

Classification du signal de risque

Exemple:

"velocity_anomaly"

score
number<float>

Score de risque entre 0 (aucun risque) et 1 (risque le plus élevé)

Plage requise: 0 <= x <= 1
Exemple:

0.85

details
object

Métadonnées arbitraires associées au signal

Exemple:
entity_type
enum<string>

Le type d'entité auquel ce signal se rapporte

Options disponibles:
user,
device,
ip,
document,
session
Exemple:

"user"

entity_id
string

Identifiant de l'entité évaluée

Exemple:

"usr_8f14e45f"

created_at
string<date-time>