PIN 설정 (최초 1회)

Guest Member가 약관 동의 후 간편 인증을 위한 4자리 PIN을 설정합니다. **요청:** - **pending_registration_token** (필수): 초대 수락 응답에서 받은 가입 대기 토큰 - **pin** (필수): 4자리 숫자 PIN **권한:** - 인증 불필요 (가입 대기 토큰으로 검증) - Public 엔드포인트이므로 익명 요청 rate limit 적용 - 이미 PIN이 설정된 경우 에러 반환 **응답:** - Web: access_token / refresh_token 쿠키 설정 - Mobile(iOS/Android): payload에 access_token / refresh_token 포함 - **required_terms_scopes**: 추가 동의가 필요한 약관 scope 목록 - next_action: 필수 약관 미동의 시 `TERMS`, 완료 시 `MAIN` **에러:** - PIN이 이미 설정된 경우: 400 Bad Request (PIN_ALREADY_SET) - PIN 형식이 올바르지 않은 경우: 400 Bad Request (INVALID_PIN_FORMAT) - 가입 대기 토큰이 유효하지 않은 경우: 401 Unauthorized (INVALID_PENDING_REGISTRATION_TOKEN)

Authentication

AuthorizationBearer

Send a JWT access token with the Authorization header as Bearer <token>.

Request

This endpoint expects an object.
pending_registration_tokenstringRequired
pinstringRequired=4 characters

Response

PIN 설정 성공

access_tokenstring
refresh_tokenstring

Errors

400
Bad Request Error
401
Unauthorized Error