Kullanıcının onay kayıtlarını listeleyin

GET /v1/users/{user_id}/consent-records · izin consent-records:read

Bir kullanıcının onay kayıtlarını (yalnızca eklenebilen bir kanıt izi), en yeni occurred_at önce olacak şekilde imleç sayfalarında listeler. Yalnızca ileri sayfalama (after) kullanılabilir. Hatalı biçimli bir kullanıcı kimliği 404 not_found döndürür; kaydı olmayan veya bu ortamda bulunmayan bir kullanıcı için boş bir liste döner. Kayıtlar IP adresi, kullanıcı aracısı veya oturum verisi içermez.

İstek

Path parametreleri:

Alan Tür Zorunlu Açıklama
user_id string evet Kullanıcı kimliği (usr_…).

Query parametreleri:

Alan Tür Zorunlu Açıklama
limit integer hayır 1-100, varsayılan 20.
after string hayır list_metadata.after değerinden alınan opak imleç.

Yanıt

200 OK; data (onay kayıtları) ve list_metadata (before her zaman null) ile birlikte. Toplam sayı döndürülmez.

{
  "data": [
    {
      "id": "crec_01j9xk3m7q8r2s4t6v8w0y2z4b",
      "user_id": "usr_01j9xk3m7q8r2s4t6v8w0y2z4c",
      "subject_type": "document",
      "subject_id": "ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "subject_version": "2026-10",
      "content_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "locale": "en",
      "state": "accepted",
      "method": "management_api",
      "application_id": null,
      "occurred_at": "2026-10-05T09:31:12.004211Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç hatalı biçimliyse veya başka bir filtre için verilmişse.
404 not_found Kullanıcı kimliği hatalı biçimliyse.
422 validation_failed Bir query parametresi geçersizse.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmişse.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yoksa.
429 rate_limited Hız sınırı aşıldıysa; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyorsa; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl "https://api.eu.keenauth.com/v1/users/usr_01j9xk3m7q8r2s4t6v8w0y2z4c/consent-records?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

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