# Textüberschreibungen abrufen

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

Gibt die Textüberschreibungen eines Bildschirms und einer Sprache der gehosteten Seite im Umgebungsbereich oder in einem Anwendungs- bzw. Organisationsbereich (`application_id` / `org_id`) zurück. Schlüssel ohne Überschreibung verwenden den integrierten Katalogtext. Überschreibungen werden beim Veröffentlichen aktiv.

## Anfrage

| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| `screen` | Pfad | ja | Bildschirm der gehosteten Seite (z. B. `login`, `authorize`). |
| `locale` | Pfad | ja | Unterstützte Sprache (z. B. `en`, `tr`). |
| `application_id` | Query | nein | Anwendungsbereich (`app_…`). Ohne ihn und `org_id` gilt der Umgebungsbereich. |
| `org_id` | Query | nein | Organisationsbereich (`org_…`). Nicht mit `application_id` kombinierbar. |

## Antwort

`200 OK` mit allen Überschreibungen des Bereichs, Bildschirms und der Sprache.

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

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | `application_id` oder `org_id` ist fehlerhaft, oder die Anwendung existiert in dieser Umgebung nicht. |
| 422 | `validation_failed` | `application_id` und `org_id` wurden zusammen angegeben (`mutually_exclusive`) oder einer wurde wiederholt (`repeated`). |
| 401 | `unauthenticated` | Die Anmeldeinformation fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Der Anmeldeinformation fehlt die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; nach der `Retry-After`-Zeit erneut versuchen. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der `Retry-After`-Zeit erneut versuchen. |

## Beispiel

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