인증 상태 조회
인증 한 건의 상태를 조회합니다.
만료는 조회 시점에 판정해 반영하므로, ttlSeconds 가 지난 건은 이 호출에서 expired
로 바뀝니다.
pending 이 아니면 instruction 은 null 입니다 — 쓸 수 없는 안내를 계속 보여 주지
않습니다.
Authentication
AuthorizationBearer
API Key를 Bearer 토큰으로 전달
Path parameters
verificationId
Response
인증 상태
verificationId
status
pending— 코드를 기다리는 중verified— 통과. 1회용입니다 — 같은 건을 두 번 소비할 수 없습니다expired—ttlSeconds가 지남max_attempts— 대조 5회를 모두 사용canceled— 취소했거나, 같은 번호의 다른 건이 먼저 통과함failed— 전달 자체가 실패(문자 발송 실패, 통화 미응답·실패)
channel
Allowed values:
to
from
발신에 쓴 계정 보유 번호.
codeLength
remainingAttempts
남은 대조 횟수. 건당 5회에서 시작합니다.
expiresAt
createdAt
verifiedAt
instruction
사용자에게 그대로 보여 줘야 하는 것. 발신형(sms·call)은 우리가 사용자에게 코드를 전달하므로 null 입니다. 수신형 채널이 열리면 보낼 번호와 문구가 여기 담깁니다.
Errors
401
Unauthorized Error
404
Not Found Error