텍스트 재정의 가져오기
GET /v1/branding/texts/{screen}/{locale} · 권한 branding:read
호스팅 페이지의 한 화면과 로캘에 대한 텍스트 재정의를 환경 범위 또는 애플리케이션이나 조직 범위(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 | code | 조건 |
|---|---|---|
| 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"