Denetim API'si

Denetim API'si, aktif kuruluşunuzun yalnızca eklemeli denetim günlüğünün salt okunur bir akışıdır: önemli her eylem (oturum açmalar, üye değişiklikleri, deploy'lar, ayarlar düzenlemeleri ve daha fazlası) için bir olay, en yeniler önce. dashboard'da bu, Denetim sayfasıdır; özel bir CLI komutu yoktur — alaf server api aracılığıyla erişebilirsiniz.

Uç Noktalar

Denetim olaylarını listele

GET /api/audit

Her olay, aktif kuruluşunuzla sınırlıdır. Erişim role göre belirlenir: sahipler ve yöneticiler günlüğü her zaman görür, sıradan üyeler reddedilir ve kısıtlı kullanıcıların kuruluş düzeyindeki audit kaynağında açık bir audit:read iznine ihtiyacı vardır. İzinler ve roller bölümüne bakın.

Sorgu parametreleri

Tüm parametreler isteğe bağlıdır. Bir numaralandırma modu seçin: cursor (anahtar kümesi) veya page/perPage (ofset) geçirin. İmleç modu, sayfaları akışla sağlayan her şey için önerilir — eşzamanlı yazımlarda satırları kaydırmadan çalışır; sayfa modu, dashboard'un "N'den 1-50 arası gösteriliyor" sayısını destekler.

Yanıt

Her olay satırı id, eventType, resourceType, resourceId, before/after JSON anlık görüntülerini (yalnızca mutasyon olayları için; aksi takdirde null), ipAddress, userAgent ve createdAt değerlerini taşır. Satırlar, actorUserId'den çözümlenen bir actor nesnesi ({ id, email, name }) ile zenginleştirilir veya sistem tarafından yayılan olaylar için null olur.

Sayfalandırma zarfı moda bağlıdır:

• İmleç modu → { data, pageInfo: { hasNextPage, endCursor } }. Sonraki sayfa için endCursor değerini cursor olarak geri geçirin; total yoktur.
• Ofset modu → { data, total, page, perPage }.

# İmleç modu — en yeni 50 deployment-failure olayı
curl -G https://your-host/api/audit \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  --data-urlencode "cursor=" \
  --data-urlencode "limit=50" \
  --data-urlencode "eventType=deployment.failed"

# CLI kaçış yoluyla aynı şey (yol /api'ye göredir):
alaf server api /audit -q eventType=deployment.failed -q limit=50

Görebileceğiniz hatalar