텍스트 재정의 설정

PUT /v1/branding/texts/{screen}/{locale} · 권한 branding:write

하나의 화면과 로케일에 대한 텍스트 재정의를 기록합니다. 본문의 키는 추가되거나 교체되며, 다른 키는 유지됩니다. 기본 제공 카탈로그의 키만 재정의할 수 있으며, 값은 카탈로그 텍스트의 {{ placeholders }}를 그대로 유지해야 합니다. 제어 문자와 양방향 제어 문자는 거부됩니다. 보안 텍스트는 재정의할 수 없습니다. 여기에는 동의 화면, 기기 및 로그아웃 확인, 복구 코드 경고, 미리 보기 배너가 포함됩니다. 게시 시 적용됩니다.

요청

필드 유형 필수 설명
screen path 예 호스팅 페이지 화면(예: login, authorize).
locale path 예 지원되는 로케일(예: en, tr).
application_id query 아니요 애플리케이션 범위(app_…). 이 값과 org_id가 모두 없으면 환경 범위가 사용됩니다.
org_id query 아니요 조직 범위(org_…). application_id와 함께 사용할 수 없습니다.
texts object 예 키 → 값, 1–500개 키, 각 값은 1–1000자입니다.

응답

200 OK와 함께 해당 범위, 화면 및 로케일의 모든 재정의가 반환됩니다.

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

오류

HTTP code 발생 조건
400 unknown_field 본문에 알 수 없는 필드가 있거나 JSON 객체가 아닙니다.
404 not_found application_id 또는 org_id 형식이 잘못되었거나, 이 환경에 애플리케이션이 존재하지 않습니다.
422 validation_failed texts가 없거나 비어 있거나, 키가 알 수 없는 키(unknown_text_key)이거나, 플레이스홀더가 누락(placeholder_mismatch)되었거나, 로케일이 지원되지 않거나, 값이 잘못되었습니다. pointer는 /texts/<key>입니다. application_id와 org_id를 모두 지정했거나(mutually_exclusive), 하나를 반복해서 지정했습니다(repeated).
401 unauthenticated 자격 증명이 없거나, 잘못되었거나, 폐기되었습니다.
403 insufficient_permissions 자격 증명에 필요한 권한이 없습니다.
429 rate_limited 요청 한도를 초과했습니다. Retry-After 기간 후 다시 시도하십시오.
503 service_unavailable 종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 후 다시 시도하십시오.

예시

curl -X PUT "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"texts":{"title":"Hoş geldiniz"}}'