API Reference
코드 대조
사용자가 입력한 코드를 대조합니다.
틀린 코드는 에러가 아닙니다
코드가 맞지 않으면 200 과 함께 valid:false, status:"pending" 이 오고
remainingAttempts 가 하나 줄어듭니다. 사용자가 오타를 내는 건 정상 동작이지 잘못된
요청이 아닙니다 — 남은 횟수를 보여 주고 다시 받으면 됩니다.
4xx 로 가는 것은 더 시도해도 소용없는 경우뿐입니다: 만료(verification_expired),
시도 소진(max_attempts_reached), 이미 통과(already_verified).
통과하면 나머지가 닫힙니다
재발송으로 같은 번호에 여러 건이 살아 있었다면, 하나가 통과하는 순간 나머지는
canceled 가 됩니다. 쓴 코드가 다시 통하면 안 되기 때문입니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
verificationId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
code*string
사용자가 입력한 코드. 공백과 하이픈은 떼고 비교하므로 482-913 도 통합니다.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v2/verifications/VE1a2b3c4d5e6f7a8b/check" \ -H "Content-Type: application/json" \ -d '{ "code": "482913" }'{
"verificationId": "string",
"status": "pending",
"valid": true,
"remainingAttempts": 0,
"verifiedAt": "2019-08-24T14:15:22Z"
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}