API Reference
인증 시작
인증 한 건을 만들고 사용자에게 코드를 보냅니다.
v2 는 경로에 계정 ID 가 없습니다 — 계정은 API 키가 정합니다. 요청·응답 필드는 모두 camelCase 입니다.
{ "to": "01012345678", "channel": "sms" }재발송은 같은 요청을 한 번 더 부르는 것입니다
같은 번호로 다시 부르면 새 건이 생기고 앞 건도 살아 있습니다. 둘 중 어느 코드로든
통과하며, 하나가 통과하면 나머지는 자동으로 canceled 가 됩니다. 진행 중인 건이 있다고
거절하지 않습니다 — 문자를 못 받은 사용자가 만료를 기다리는 것 말고 방법이 없어지기
때문입니다.
제어는 한도가 합니다. 직전 건 생성 후 60초 안에 다시 부르면 429 이고,
같은 번호로 시간당 5건·하루 10건·동시 5건까지입니다.
코드는 응답에 실리지 않습니다
코드가 사용자에게 가는 경로는 문자 본문 하나뿐이고, 저장도 해시로만 합니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v2/verifications" \ -H "Content-Type: application/json" \ -d '{ "to": "01012345678", "channel": "sms" }'{
"verificationId": "VE1a2b3c4d5e6f7a8b",
"status": "pending",
"channel": "sms",
"to": "01012345678",
"from": "07052358010",
"codeLength": 6,
"remainingAttempts": 5,
"expiresAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"verifiedAt": "2019-08-24T14:15:22Z",
"instruction": {
"type": "string",
"sendTo": "string",
"body": "string",
"callTo": "string",
"code": "string",
"deadline": "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·대표번호만 발급됩니다."
}
]
}{
"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·대표번호만 발급됩니다."
}
]
}