テキストの上書きを取得
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 とスコープ、画面、ロケールのすべての上書き。
{"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 の期間後に再試行してください。 |
例
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"