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

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

```bash
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```
