인증 상태 조회
인증 한 건의 상태를 조회합니다.
만료는 조회 시점에 판정해 반영하므로, 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 입니다.
수신형(sms_inbound)은 pending 인 동안만 채워집니다 — sendTo 로 body 를 보내라고 화면에 띄우면 됩니다. 건이 끝나면 null 이 됩니다.
Errors
401
Unauthorized Error
404
Not Found Error