Listar permisos

GET /v1/permissions · permiso apis:read

Devuelve los permisos (scopes de OAuth) de una API, del más reciente al más antiguo, en páginas por cursor, junto con los textos que se muestran en la pantalla de consentimiento. El entorno proviene solo de la credencial.

Solicitud

Parámetro	Tipo	Obligatorio	Descripción
`api_id`	cadena	sí	La API (`api_…`). Si falta, se repite o tiene formato incorrecto, responde `422` con puntero `/api_id`.
`limit`	entero	no	De 1 a 100, predeterminado 20.
`after`	cadena	no	Cursor de `list_metadata.after`. Excluyente con `before`.
`before`	cadena	no	Cursor de `list_metadata.before`.
`order`	cadena	no	`asc` o `desc` (predeterminado). Un cursor solo es válido con el mismo `api_id` y `order`.

Respuesta

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" }
}

Un permiso sin textos de consentimiento tiene display_name y description en null, y consent_text_i18n en {}. Un cursor null significa que no hay más registros en esa dirección. No se devuelve un recuento total.

Errores

HTTP	código	Cuándo
400	`invalid_cursor`	El cursor tiene formato incorrecto, ha sido manipulado, o se emitió para otro entorno, otro `api_id` u otro `order`.
403	`insufficient_permissions`	La credencial no tiene `apis:read`.
404	`not_found`	No existe tal API en este entorno.
422	`validation_failed`	`api_id` falta, se repite o tiene formato incorrecto, o otro parámetro de consulta no es válido.

Ejemplo

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