# Ottenere le sostituzioni di testo

`GET /v1/branding/texts/{screen}/{locale}` · permesso `branding:read`

Restituisce le sostituzioni di testo di una schermata e di una lingua della pagina ospitata nell'ambito ambiente, oppure in un ambito applicazione o organizzazione (`application_id` / `org_id`). Le chiavi senza sostituzione usano il testo del catalogo integrato. Le sostituzioni diventano attive alla pubblicazione.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `screen` | percorso | sì | Schermata della pagina ospitata (ad es. `login`, `authorize`). |
| `locale` | percorso | sì | Lingua supportata (ad es. `en`, `tr`). |
| `application_id` | query | no | Ambito applicazione (`app_…`). Senza di esso e senza `org_id` si usa l'ambito ambiente. |
| `org_id` | query | no | Ambito organizzazione (`org_…`). Non combinabile con `application_id`. |

## Risposta

`200 OK` con tutte le sostituzioni dell'ambito, della schermata e della lingua.

```json
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
```

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | `application_id` o `org_id` non è valido, oppure l'applicazione non esiste in questo ambiente. |
| 422 | `validation_failed` | Sono stati indicati sia `application_id` sia `org_id` (`mutually_exclusive`), oppure uno è stato ripetuto (`repeated`). |
| 401 | `unauthenticated` | La credenziale manca, non è valida o è stata revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | Il limite di frequenza è stato superato; riprovare dopo il periodo `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprovare dopo il periodo `Retry-After`. |

## Esempio

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