Geschwindigkeitsereignis aufzeichnen
curl --request POST \
--url https://api.truthlocks.com/v1/risk/velocity/record \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"action_type": "<string>",
"subject_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({action_type: '<string>', subject_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/risk/velocity/record', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/risk/velocity/record"
payload = {
"action_type": "<string>",
"subject_id": "<string>"
}
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/velocity/record"
payload := strings.NewReader("{\n \"action_type\": \"<string>\",\n \"subject_id\": \"<string>\"\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))
}{
"event_id": "<string>",
"current_count": 123,
"window": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Geschwindigkeitsbewertung
Geschwindigkeitsaktion aufzeichnen
Zeichnet eine Subjektaktion auf und bewertet sie anhand einer geschwindigkeitsbasierten Anomaliebewertung. Nimmt automatisch ein Risikosignal auf, wenn der Geschwindigkeitsscore 60 oder höher erreicht.
POST
/
v1
/
risk
/
velocity
/
record
Geschwindigkeitsereignis aufzeichnen
curl --request POST \
--url https://api.truthlocks.com/v1/risk/velocity/record \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"action_type": "<string>",
"subject_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({action_type: '<string>', subject_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/risk/velocity/record', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/risk/velocity/record"
payload = {
"action_type": "<string>",
"subject_id": "<string>"
}
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/velocity/record"
payload := strings.NewReader("{\n \"action_type\": \"<string>\",\n \"subject_id\": \"<string>\"\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))
}{
"event_id": "<string>",
"current_count": 123,
"window": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Zeichnet eine Aktion für ein Subjekt auf und aktualisiert gleitende Fensterzähler über vier Zeitfenster (1 m, 5 m, 1 h, 24 h). Ein gewichteter Geschwindigkeitsscore wird aus den aktualisierten Zählungen berechnet. Wenn der Score 60 oder höher erreicht, wird automatisch ein Risikosignal mit
signal_type: "velocity" in die Risikosignal-Pipeline aufgenommen.
Den vollständigen Workflow, das Bewertungsmodell und die Integrationsmuster finden Sie im Handbuch zur Geschwindigkeits- und Anomaliebewertung.
Bewertungsgewichtungen
| Fenster | Gewicht | Zweck |
|---|---|---|
| 1 Minute | 30 | Burst-Erkennung |
| 5 Minuten | 20 | Anhaltender kurzfristiger Missbrauch |
| 1 Stunde | 10 | Mittelfristige Muster |
| 24 Stunden | 5 | Anhaltende Anomalien |
Antwort
Gewichteter Geschwindigkeitsscore (0–100). Scores von 60 oder höher lösen eine automatische Signalerfassung aus.
true, wenn ein Risikosignal automatisch erfasst wurde, weil der Geschwindigkeitsscore 60 oder höher erreichte.UUID des automatisch aufgenommenen Risikosignals (nur vorhanden, wenn
signal_ingested true ist).
