İzinleri listele

GET /v1/permissions · izin apis:read

Bir API'nin izinlerini (OAuth scope'ları) onay ekranında gösterilen metinleriyle birlikte, en yeniden eskiye imleçli sayfalarla döner. Ortam yalnız kimlik bilgisinden gelir.

İstek

Parametre Tür Zorunlu Açıklama
api_id string evet API (api_…). Yoksa, tekrarlanırsa ya da biçimsizse /api_id işaretçili 422.
limit integer hayır 1-100, varsayılan 20.
after string hayır list_metadata.after'daki imleç. before ile birlikte verilemez.
before string hayır list_metadata.before'daki imleç.
order string hayır asc ya da desc (varsayılan). İmleç yalnız aynı api_id ve order ile geçerlidir.

Yanıt

200 OK

{
  "data": [ {
  "id": "perm_01h455vb4pex5vsknk084sn02s",
  "api_id": "api_01h455vb4pex5vsknk084sn02q",
  "value": "read:orders",
  "display_name": "Read orders",
  "description": "See your past orders and their status",
  "consent_text_i18n": {
    "en": "Read your orders",
    "tr": "Siparişlerinizi okuyun"
  },
  "sensitivity": "normal"
} ],
  "list_metadata": { "before": null, "after": "eyJ2IjoxLi4ufQ" }
}

Onay metni olmayan izinde display_name ve description null, consent_text_i18n {}'dir. null imleç o yönde başka kayıt olmadığını söyler. Toplam sayı döndürülmez.

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç bozuk, kurcalanmış ya da başka bir ortam, api_id veya order için üretilmiş.
403 insufficient_permissions Kimlik bilgisinde apis:read yok.
404 not_found Bu ortamda böyle bir API yok.
422 validation_failed api_id yok, tekrarlı ya da biçimsiz, ya da başka bir sorgu parametresi geçersiz.

Örnek

curl "https://api.eu.keenauth.com/v1/permissions?api_id=api_01h455vb4pex5vsknk084sn02q&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"