브랜딩 미리 보기 링크 만들기
POST /v1/branding:preview-link · 권한 branding:write
게시하기 전에 환경의 현재 브랜딩 초안을 적용한 호스팅 로그인 페이지를 보여 주는 링크를 만듭니다. 페이지는 항상 최신 초안을 그립니다. 초안을 변경한 뒤 페이지를 새로 고치면 변경 사항이 보입니다. 페이지 상단에는 미리 보기임을 알리는 배너가 표시되고, 모든 로그인 컨트롤은 비활성화됩니다. 초안의 텍스트 재정의는 페이지의 언어로 표시되며, 미리 보기 배너는 바꿀 수 없습니다.
링크는 10분 동안 유효하며 취소할 수 없습니다. 그 이후에는 404를 반환합니다. 링크를 가진 사람은 누구나 초안을 볼 수 있으므로, 디자인을 검토할 사람에게만 공유하십시오. 환경에는 동시에 유효한 링크가 최대 20개까지 있을 수 있습니다.
요청
본문은 선택 사항입니다. 본문이 없으면 페이지에 환경 초안만 표시됩니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
application_id |
string | 아니요 | 이 애플리케이션의 초안도 적용합니다 (app_…). |
org_id |
string | 아니요 | 이 조직의 초안도 적용합니다 (org_…): 로고와 기본 색상. |
응답
200 OK. url은 이 응답에서만 반환되며 Cache-Control: no-store 헤더가 함께 전달됩니다. 같은 Idempotency-Key로 반복한 요청은 url 대신 secret_redacted: true를 반환합니다. 이때는 새 링크를 만드십시오.
{
"url": "https://acme.eu1.keenauth.app/u/preview?token=…",
"expires_at": "2026-10-19T12:10:00Z"
}
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 400 | unknown_field |
본문에 알 수 없는 필드가 있거나 JSON 객체가 아닙니다. |
| 404 | not_found |
이 환경에 해당 애플리케이션이 없습니다. |
| 422 | validation_failed |
application_id 또는 org_id가 올바른 ID가 아닙니다 (invalid_value). |
| 401 | unauthenticated |
자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
환경에 유효한 링크가 이미 20개 있거나 속도 제한을 초과했습니다. Retry-After 기간이 지난 후에 다시 시도하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간이 지난 후에 다시 시도하십시오. |
예시
curl -X POST https://api.eu.keenauth.com/v1/branding:preview-link \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"application_id":"app_01jb…"}'
CLI 사용:
keenauth branding preview-link --application-id app_01jb…