브랜딩 초안 게시

POST /v1/branding:publish · 권한 branding:write

모든 초안(환경, 애플리케이션, 조직, 텍스트)의 스냅샷을 만들어 호스팅 페이지의 라이브 버전으로 지정합니다. 게시 전에 모든 범위의 유효 테마를 검사합니다: 필수 토큰, 값 범위, 각 색상 쌍의 WCAG 대비. 문제가 하나라도 있으면 전체 게시가 422 branding_validation_failed로 거부되며, issues[] 목록이 변경해야 할 모든 토큰을 알려 줍니다(대비의 경우 측정된 ratio, threshold, 기준을 충족하는 가장 가까운 suggestion 포함). 최근 50개 버전이 보관됩니다. Idempotency-Key는 선택 사항입니다.

초안에 사용자 지정 CSS가 있으면 게시 전에 호스팅 화면에 렌더링하여 검사합니다(최대 25초가 걸릴 수 있는 렌더링 검사이므로 클라이언트 시간 제한을 최소 30초로 설정하세요). 보호된 요소를 깨뜨리거나, CSS가 없으면 페이지에 없을 접근성 위반을 추가하는 CSS는 422 branding_validation_failed와 render_violations[] 목록으로 게시를 거부합니다. 검사 중 초안이 변경되면 아무것도 게시되지 않고 409 conflict가 반환됩니다. 다시 게시하세요.

요청

이 작업은 경로, 쿼리, 본문 필드를 받지 않습니다. 환경은 자격 증명에서 결정됩니다.

응답

200 OK와 새 버전의 메타데이터 (스냅샷 자체는 반환되지 않습니다).

{
  "version": 4,
  "snapshot_sha256": "3f1c…",
  "source": "publish",
  "rolled_back_from": null,
  "actor_type": "api_key",
  "actor_id": "key_01jb…",
  "published_at": "2026-10-05T09:31:00Z"
}

{
  "type": "https://docs.keenauth.com/problems/branding_validation_failed",
  "status": 422,
  "code": "branding_validation_failed",
  "issues": [
    {"scope_type": "environment", "code": "brand_contrast_insufficient", "field": "light.color.primary_contrast",
     "variant": "light", "pair": "primary_contrast_on_primary", "ratio": 2.1, "threshold": 4.5, "suggestion": "#ffffff"}
  ]
}

렌더링 검사 거부는 모든 발견 사항을 나열합니다: screen(예: password), locale(en, ar 또는 ja), width(CSS 픽셀 단위의 뷰포트 너비, 320 또는 1280), rule(protected_no_area, protected_not_visible, protected_transparent, protected_covered, protected_contrast 또는 color-contrast와 같은 axe-core 규칙 ID), target(보호된 요소의 이름 또는 axe-core CSS 선택자). CSS 값은 응답에 포함되지 않습니다. 발견 사항은 최대 100개가 반환되며, 더 많은 경우 render_violations_truncated가 true입니다.

{
  "type": "https://docs.keenauth.com/errors/branding_validation_failed",
  "status": 422,
  "code": "branding_validation_failed",
  "render_violations": [
    {"screen": "recovery", "locale": "ar", "width": 320, "rule": "protected_covered", "target": "recovery_codes_hint"}
  ],
  "render_violations_truncated": false
}

오류

예제

curl -X POST https://api.eu.keenauth.com/v1/branding:publish \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"