
# 텍스트 재정의 가져오기

`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`와 해당 범위, 화면, 로캘의 모든 재정의.

```json
{"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` 기간 후에 다시 시도하세요. |

## 예제

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