
# テキストの上書きを取得

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

ホスト型ページの 1 つの画面とロケールのテキスト上書きを、環境スコープ、またはアプリケーションや組織のスコープ (`application_id` / `org_id`) で返します。上書きのないキーは組み込みカタログのテキストを使用します。上書きは公開時に有効になります。

## リクエスト

| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| `screen` | パス | はい | ホスト型ページの画面 (例: `login`、`authorize`)。 |
| `locale` | パス | はい | サポートされるロケール (例: `en`、`tr`)。 |
| `application_id` | クエリ | いいえ | アプリケーションスコープ (`app_…`)。これと `org_id` がない場合は環境スコープ。 |
| `org_id` | クエリ | いいえ | 組織スコープ (`org_…`)。`application_id` と同時に指定できません。 |

## レスポンス

`200 OK` とスコープ、画面、ロケールのすべての上書き。

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

## エラー

| HTTP | コード | 概要 |
|---|---|---|
| 404 | `not_found` | `application_id` または `org_id` の形式が不正か、この環境にアプリケーションが存在しません。 |
| 422 | `validation_failed` | `application_id` と `org_id` が同時に指定された (`mutually_exclusive`)、またはどちらかが繰り返された (`repeated`)。 |
| 401 | `unauthenticated` | 認証情報がない、無効、または失効しています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間後に再試行してください。 |
| 503 | `service_unavailable` | 依存サービスが一時的に利用できません。`Retry-After` の期間後に再試行してください。 |

## 例

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