Denetim dışa aktarımını al

GET /v1/audit-exports/{export_id} · izin audit-exports:read

Bir dışa aktarma işini ve durumunu döndürür: queued, running, completed, failed veya expired.

İstek

Parametre	Konum	Zorunlu	Açıklama
`export_id`	yol	evet	`aex_` önekli dışa aktarma işi kimliği.

Yanıt

200 OK ve iş. Boş alanlar null değerindedir.

record_count, file ve manifest_sha256 yalnızca completed ve expired işlerinde doldurulur. file, paket içindeki records.ndjson.gz dosyasını açıklar (sha256 onaltılık sayıdır).
failure_reason yalnızca failed işlerinde doldurulur: too_many_records, checkpoint_unavailable, integrity_error veya attempts_exhausted.
Dosya expires_at zamanında silinir (completed_at artı 7 gün); iş bundan sonra expired durumunu gösterir ve artık indirilemez.

{
  "id": "aex_01j9xk3m7q8r2s4t6v8w0y2z4e",
  "status": "completed",
  "filter": {
    "stream": "admin",
    "from": "2026-07-01T00:00:00Z",
    "to": "2026-10-01T00:00:00Z",
    "action": "user.",
    "category": null,
    "actor_type": null,
    "actor_id": null,
    "target_type": null,
    "target_id": null,
    "org_id": null,
    "outcome": null,
    "request_id": null,
    "correlation_id": null,
    "agent_only": false
  },
  "include_ip": false,
  "record_count": 18240,
  "file": {
    "name": "records.ndjson.gz",
    "sha256": "9f2c4b8e1d7a3f6c0b5e8d2a4c7f1e3b6a9d0c2e5f8b1a4d7c0e3f6a9b2c5d8e",
    "size": 2381904
  },
  "manifest_sha256": "3b7e1f9c2d5a8e0b4f6c1a3d7e9b2f5c8a0d4e6b1c3f7a9e2d5b8c0f4a6e1d3b",
  "failure_reason": null,
  "created_at": "2026-10-19T09:00:00Z",
  "started_at": "2026-10-19T09:00:02Z",
  "completed_at": "2026-10-19T09:01:10Z",
  "expires_at": "2026-10-26T09:01:10Z",
  "recorded_before": "2026-10-19T09:00:00Z",
  "requested_by": {"type": "api_key", "id": "key_01j9xk3m7q8r2s4t6v8w0y2z4d"}
}

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP	`code`	Ne zaman
401	`unauthenticated`	API anahtarı eksik, geçersiz veya iptal edilmiş.
403	`insufficient_permissions`	Anahtarda `audit-exports:read` izni yok.
404	`not_found`	İş mevcut değil, başka bir ortama ait veya kimlik hatalı biçimlendirilmiş.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` değerine uyun.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

curl https://api.eu.keenauth.com/v1/audit-exports/aex_01j9xk3m7q8r2s4t6v8w0y2z4e \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth audit-exports get aex_01j9xk3m7q8r2s4t6v8w0y2z4e

Kişisel veriler

Bu uç nokta kişisel veri içerir: denetim olayları. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süre tutulduğu ve nasıl silindiği açıklanır. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.