Uygulamaları listeleme
GET /v1/applications · izin applications:read
Ortamın uygulamalarını en yeniden en eskiye doğru listeler (order=asc sırayı tersine çevirir). Sayfalama imleç tabanlıdır: sonraki sayfa için list_metadata.after değerini after olarak, önceki sayfa için list_metadata.before değerini before olarak gönderin. Bir imleç, verildiği filtre ve sıraya bağlıdır; başka filtrelerle kullanılırsa 400 invalid_cursor döner. Toplam kayıt sayısı döndürülmez.
İstek
| Parametre | Tür | Açıklama |
|---|---|---|
limit |
integer | 1-100, varsayılan 20. |
after / before |
string | Opak imleçler; ikisi birlikte kullanılamaz. |
order |
string | desc (varsayılan) veya asc. |
app_type |
string | Filtre: web, spa, native, m2m, device, management. |
status |
string | Filtre: active veya suspended. |
Yanıt
200 OK.
{
"data": [ { "id": "app_6f8d0cjgbmf0gtn2rg6pscp3cg", "key": "portal", "…": "…" } ],
"list_metadata": { "before": null, "after": "<cursor>" }
}
Hatalar
| HTTP | code |
Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Anahtar eksik, geçersiz veya iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarın gerekli izni yok. |
| 400 | invalid_cursor |
İmleç hatalı biçimde, başka filtreler ya da sıra için verilmiş veya başka bir ortama ait. |
| 422 | validation_failed |
Bir sorgu parametresi geçersiz (limit, order, app_type, status). |
Örnek
curl "https://api.eu.keenauth.com/v1/applications?limit=20&app_type=web" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"