Yönetim istemcilerini listele

GET /v1/management-clients · izin management-clients:read

Ortamın yönetim istemcisi kayıtlarını imleçli sayfalarla, application_id sırasıyla (varsayılan azalan) döner. Kayıt management türündeki bir uygulamaya aittir ve onun yönetim API'sindeki izin tavanını ve IP izin listesini tutar. İstemcinin imza anahtarları bu kaynakta yoktur: onları /v1/applications/{application_id}/credentials ile yönetin. Bu ucu yalnız API anahtarı çağırabilir; ortam anahtardan gelir.

İstek

Parametre Tür Zorunlu Açıklama
limit integer hayır 1-100, varsayılan 20.
after string hayır list_metadata.after imleci. before ile birlikte verilmez.
before string hayır list_metadata.before imleci.
order string hayır asc ya da desc (varsayılan). İmleç yalnız aynı order ile geçerlidir.

Yanıt

200 OK

{
  "data": [
    {
      "application_id": "app_01h455vb4pex5vsknk084sn02q",
      "permissions": ["users:read", "users:write"],
      "allowed_cidrs": ["203.0.113.0/24"]
    }
  ],
  "list_metadata": { "before": null, "after": null }
}

null imleç o yönde başka kayıt olmadığı anlamına gelir. Toplam sayı döndürülmez. Uygulama silinince kaydı da silinir; uygulaması artık olmayan kayıt hiç listelenmez ve bir sayfa ona ulaştığında silinir, bu yüzden after doluyken sayfada limit değerinden az kayıt olabilir. İmleci izlemeye devam edin.

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç bozuk, değiştirilmiş ya da başka bir ortam veya order için verilmiş.
403 insufficient_permissions Kimlik bilgisinde management-clients:read yok ya da kimlik bilgisi API anahtarı değil.
422 validation_failed Bir sorgu parametresi geçersiz.

Örnek

curl "https://api.eu.keenauth.com/v1/management-clients?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth management-clients list --limit 20