Evaluar riesgo
curl --request POST \
--url https://api.truthlocks.com/v1/risk/evaluate \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"subject_id": "<string>",
"risk_score": 50
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({subject_id: '<string>', risk_score: 50})
};
fetch('https://api.truthlocks.com/v1/risk/evaluate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/risk/evaluate"
payload = {
"subject_id": "<string>",
"risk_score": 50
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/risk/evaluate"
payload := strings.NewReader("{\n \"subject_id\": \"<string>\",\n \"risk_score\": 50\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"decision_id": "<string>",
"signal_id": "<string>",
"decision": "allow",
"policy_id": "<string>",
"receipt_id": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Evaluación de Riesgos
Evaluar riesgo
Endpoint unificado de evaluación de riesgos. Ingresa una señal, la evalúa según las políticas de su inquilino, crea una decisión de riesgo firmada y, opcionalmente, acuña un fraud_decision_receipt para la no repudiación.
POST
/
v1
/
risk
/
evaluate
Evaluar riesgo
curl --request POST \
--url https://api.truthlocks.com/v1/risk/evaluate \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"subject_id": "<string>",
"risk_score": 50
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({subject_id: '<string>', risk_score: 50})
};
fetch('https://api.truthlocks.com/v1/risk/evaluate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/risk/evaluate"
payload = {
"subject_id": "<string>",
"risk_score": 50
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/risk/evaluate"
payload := strings.NewReader("{\n \"subject_id\": \"<string>\",\n \"risk_score\": 50\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"decision_id": "<string>",
"signal_id": "<string>",
"decision": "allow",
"policy_id": "<string>",
"receipt_id": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Cómo funciona la evaluación
- La señal se ingiere en
risk_signals - Se evalúan las reglas de su política activa (la coincidencia de mayor prioridad gana)
- Se crea un registro
risk_decisioncon el resultado - Si se proporcionan
mint_receipt: trueyissuer_id/kid, se acuña unfraud_decision_receipta través del servicio de atestación
Resultados de la decisión
| Acción | Significado |
|---|---|
allow | Ninguna política coincidió o la puntuación está por debajo de todos los umbrales |
challenge | Se requiere MFA o autenticación por pasos |
block | Rechazar la acción por completo |
review | Enviar a la cola de revisión manual de fraude |
Tipos de recibos integrados
| Tipo de recibo | Propósito |
|---|---|
fraud_decision_receipt | Registra la decisión de permitir/desafiar/bloquear/revisar |
ato_alert_receipt | Registra eventos de alerta ATO |
risk_block_receipt | Prueba que una acción fue bloqueada |
deepfake_detection_receipt | Registra los resultados del escaneo de deepfake |
Respuesta
Cuerpo
application/json

