Kullanıcının onaylarını listeleme

GET /v1/users/{user_id}/consents · izin users:read

Kullanıcının uygulamalara verdiği OAuth onaylarını en yeniden eskiye doğru listeler. Yalnızca etkin onaylar döndürülür: iptal edilmiş ya da aynı uygulamanın daha yeni bir onayıyla değiştirilmiş onaylar listelenmez. Liste yalnızca ileriye doğru sayfalanır ve toplam sayı döndürmez. Yanıt, kullanıcının gördüğü onay ekranının metnini içermez.

İstek

Parametre	Konum	Zorunlu	Açıklama
`user_id`	path	evet	Kullanıcı kimliği, `usr_` önekiyle.
`limit`	query	hayır	Sayfa başına öğe sayısı, 1-100 (varsayılan 20).
`after`	query	hayır	Aynı kullanıcının önceki sayfasındaki `list_metadata.after` imleci.

before ve order=asc desteklenmez ve 422 döndürür.

Yanıt

200 OK. Boş alanlar null olur.

{
  "data": [
    {
      "id": "cns_01jb2k8m5c3f6t9w2y4b7d0g3k",
      "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
      "application_id": "app_0a1b2c3d4e5f6g7h8j9k0m1n2p",
      "api_id": "api_0a1b2c3d4e5f6g7h8j9k0m1n2p",
      "org_id": null,
      "scopes": ["openid", "profile", "orders:read"],
      "authorization_details_types": [],
      "granted_at": "2026-10-20T09:00:00Z",
      "consent_screen_version": "3",
      "locale": "en",
      "prompt_reason": "scope_expansion"
    }
  ],
  "list_metadata": {"before": null, "after": null}
}

Alan	Açıklama
`id`	Onay kimliği, `cns_` önekiyle.
`application_id`	Onayın verildiği uygulama.
`api_id`	Onayın bağlı olduğu API, varsa.
`org_id`	Onayın verildiği kuruluş bağlamı, varsa.
`scopes`	Verilen kapsamlar, sıralı ve benzersiz.
`authorization_details_types`	Verilen zengin yetkilendirme isteği türleri; yoksa boş.
`consent_screen_version`, `locale`	Kullanıcının kabul ettiği onay ekranının sürümü ve dili.
`prompt_reason`	Onayın neden istendiği: `first`, `scope_expansion`, `prompt_consent` veya `skip_consent` (onay ekranı olmayan birinci taraf uygulama).

Hatalar

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

HTTP	`code`	Ne zaman
400	`invalid_cursor`	İmleç hatalı biçimlendirilmiş veya başka bir listeye ait.
422	`validation_failed`	`limit` aralık dışında veya `before` ya da artan bir `order` gönderildi.
404	`not_found`	Kullanıcı bu ortamda yok (ya da kimlik hatalı biçimlendirilmiş).
401	`unauthenticated`	API anahtarı eksik, geçersiz veya iptal edilmiş.
403	`insufficient_permissions`	Anahtarda `users:read` izni yok.
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/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/consents?limit=50" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth users consents list usr_0a1b2c3d4e5f6g7h8j9k0m1n2p --limit 50

Kişisel veriler

Bu uç nokta kişisel veri içerir: onay kayıtları. KeenAuth API'lerinde kişisel veriler saklanan verileri, ne kadar süreyle tutulduklarını ve nasıl silindiklerini 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.