# 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`

```json
{
  "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

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

CLI: `keenauth management-clients list --limit 20`