Denetim kaydını listeler
GET/api/v1/audit-logs
En yeni önce. Ham ayrıntı dönmez: summary temizlenmiş özettir (e-posta, telefon, IP, sır ve serbest metin içermez), işlemi yapan yalnız user_id ile görünür. Yönetici yetkisi gerekir. Kapsam: organization:read.
- Kapsam
organization:read- SDK metodu
- listAuditLogs · list_audit_logs
- MCP aracı
listAuditLogssalt okunur
Parametreler
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
categorysorgu | enum | hayır | İşlem kategorisiauth | account | org | team | bot | conversation | contact | campaign | automation | knowledge | community | post | miniapp | upload | apikey | webhook | plan | billing | affiliate | store |
user_idsorgu | uuid | hayır | İşlemi yapan kullanıcı |
fromsorgu | date | hayır | Başlangıç günü (YYYY-MM-DD, UTC) |
tosorgu | date | hayır | Bitiş günü, dahil (YYYY-MM-DD, UTC) |
limitsorgu | integer | hayır | Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400val 1–200, default 50 |
cursorsorgu | string | hayır | Önceki yanıttaki next_cursor (opak) |
Örnek istek
curl -X GET "https://hiboty.com/api/v1/audit-logs?limit=50" \
-H "Authorization: Bearer $HIBOTY_API_KEY"Örnek yanıt (200)
JSON
{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"action": "string",
"action_name": "string",
"category": "string",
"user_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"target": "string",
"summary": "string",
"created_at": "2026-11-06T09:00:00.000Z"
}
],
"next_cursor": "string"
}Olası hatalar
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.