Listar aplicaciones
GET /v1/applications · permiso applications:read
Lista las aplicaciones del entorno, las más nuevas primero (order=asc lo invierte). La paginación está basada en cursor: pasa list_metadata.after como after para la siguiente página y list_metadata.before como before para la anterior. Un cursor está vinculado a los filtros y al orden para el que fue emitido; usarlo con otros filtros devuelve 400 invalid_cursor. No se devuelve un recuento total.
Solicitud
| Parámetro | Tipo | Descripción |
|---|---|---|
limit |
integer | 1-100, predeterminado 20. |
after / before |
string | Cursores opacos; no ambos. |
order |
string | desc (predeterminado) o asc. |
app_type |
string | Filtro: web, spa, native, m2m, device, management. |
status |
string | Filtro: active o suspended. |
Respuesta
200 OK.
{
"data": [ { "id": "app_6f8d0cjgbmf0gtn2rg6pscp3cg", "key": "portal", "…": "…" } ],
"list_metadata": { "before": null, "after": "<cursor>" }
}
Errores
| HTTP | code |
Cuándo |
|---|---|---|
| 401 | unauthenticated |
La clave falta, no es válida o ha sido revocada. |
| 403 | insufficient_permissions |
La clave carece del permiso requerido. |
| 400 | invalid_cursor |
El cursor está mal formado, fue emitido para otros filtros u orden, o pertenece a otro entorno. |
| 422 | validation_failed |
Un parámetro de consulta no es válido (limit, order, app_type, status). |
Ejemplo
curl "https://api.eu.keenauth.com/v1/applications?limit=20&app_type=web" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"