Obtener las sustituciones de texto
GET /v1/branding/texts/{screen}/{locale} · permiso branding:read
Devuelve las sustituciones de texto de una pantalla y un idioma de la página alojada en el ámbito del entorno, o en un ámbito de aplicación u organización (application_id / org_id). Las claves sin sustitución usan el texto del catálogo integrado. Las sustituciones se activan al publicar.
Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
screen |
ruta | sí | Pantalla de la página alojada (p. ej. login, authorize). |
locale |
ruta | sí | Idioma compatible (p. ej. en, tr). |
application_id |
consulta | no | Ámbito de aplicación (app_…). Sin él ni org_id se usa el ámbito del entorno. |
org_id |
consulta | no | Ámbito de organización (org_…). No se puede combinar con application_id. |
Respuesta
200 OK con todas las sustituciones del ámbito, la pantalla y el idioma.
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
Errores
| HTTP | código | Cuándo |
|---|---|---|
| 404 | not_found |
application_id u org_id está mal formado, o la aplicación no existe en este entorno. |
| 422 | validation_failed |
Se indicaron application_id y org_id a la vez (mutually_exclusive), o uno se repitió (repeated). |
| 401 | unauthenticated |
La credencial falta, no es válida o se ha revocado. |
| 403 | insufficient_permissions |
La credencial no tiene el permiso necesario. |
| 429 | rate_limited |
Se superó el límite de frecuencia; vuelva a intentarlo tras el periodo Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; vuelva a intentarlo tras el periodo Retry-After. |
Ejemplo
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"