API başvurusu

Denetim

Bu gruptaki 1 uç.

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

Sayfalı

Parametreler

AdTürZorunluAçıklama
categorysorguenumhayırİşlem kategorisiauth | account | org | team | bot | conversation | contact | campaign | automation | knowledge | community | post | miniapp | upload | apikey | webhook | plan | billing | affiliate | store
user_idsorguuuidhayırİşlemi yapan kullanıcı
fromsorgudatehayırBaşlangıç günü (YYYY-MM-DD, UTC)
tosorgudatehayırBitiş günü, dahil (YYYY-MM-DD, UTC)
limitsorguintegerhayırSayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400val 1–200, default 50
cursorsorgustringhayı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.