OTP 인증 API
재판매자를 위해
한 REST API를 통해 $0.10부터 단일 사용 SMS 인증 번호를 재판매하세요. 즉시 제공, 사용되지 않은 활성화에 대한 전액 환불, 서명된 웹훅 — 실제 통신사 번호 위에 자체 OTP 플랫폼을 구축할 수 있습니다.
필요한 모든 일회용 SMS 인증을 위한 하나의 API
무료 공개 SMS 수신함은 공개적으로 읽을 수 있으며 모든 주요 플랫폼에서 이미 표시됩니다. 단일 사용 번호에 대한 자체 통신사 관계를 구축하는 것은 설정 비용이 많이 들며, 고객은 한 번 사용하고 버립니다.
VRNUM OTP API는 실시간으로 요청할 수 있는 실제 통신사 번호의 비공개 풀을 제공합니다. 하나를 제공받고 코드를 받으면 해당 번호는 다른 누구에게도 표시되지 않으며, 표시되는 모든 가격에는 이미 귀하의 마진이 적용됩니다.
주문에서 인증 코드까지
OTP 전체 수명 주기는 네 번의 호출로 완료됩니다.
카탈로그 확인
실시간 서비스, 국가 및 가격은 GET /otp-catalog를 확인하세요 — 고객에게 표시하기 전에 마크업을 적용하세요.
번호 주문하기
POST /otp-numbers를 사용하여 서비스, 국가 및 Idempotency-Key와 함께 요청하세요. 번호는 즉시 반환됩니다.
코드 받기
GET /otp-numbers/:id를 사용하여 SMS를 실시간으로 확인하거나 otp.completed 웹훅 이벤트를 기다리세요.
재전송 또는 환불
아직 코드가 없나요? /resend를 시도하거나 /cancel을 통해 지갑에 즉시 전액 환불을 받을 수 있습니다.
한 번의 요청으로 OTP 번호 주문
clientReference는 내부 고객 기록과 주문을 대조하기 위해 첨부하는 사용자의 자체 불투명 ID입니다.
curl -X POST https://vrnum.com/api/v1/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'완전한 OTP 주문 수명 주기
카탈로그, 주문, 재전송, 취소/환불, 웹훅 — 하나의 일관된 JSON API.
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balance전체 요청/응답 문서와 키는 로그인한 후대시보드에 있습니다.
OTP 인증 API를 사용하는 사람
한 번의 인증 단계에 실제 전화번호가 필요한 모든 제품.
SMS 인증 플랫폼
모든 서비스에 대해 자체 마크업을 적용하여 자신의 브랜드로 OTP 번호를 고객에게 재판매합니다.
QA 및 테스트 자동화
개인 전화번호를 사용하지 않고도 실제 서비스에서 일회용 테스트 계정을 생성합니다.
봇 및 에이전시 도구
클라이언트를 위해 구축된 계정 생성 워크플로우에 대해 전화번호를 프로그램적으로 제공하세요.
개발자 도구
텔레콤 인프라를 소유하지 않고도 자체 앱이나 SDK에서 'SMS로 확인' 기능을 제공하세요.
신뢰할 수 있어 자체 고객에게 청구 가능
멱등 키(Idempotency keys)
타임아웃 시 안전하게 재시도 가능 — 동일한 멱등 키는 항상 원래 주문을 반환하며, 중복은 발생하지 않습니다.
서명된 웹훅
otp.completed, number.provisioned, number.provisioning_failed 이벤트는 X-VRNUM-Signature로 서명됩니다.
자동 재시도
웹훅 전달 실패 시, 포기하기 전까지 백오프 일정(5분, 30분, 2시간, 6시간, 24시간)에 따라 재시도합니다.
투명한 속도 제한
모든 응답에 X-RateLimit-* 헤더와 함께 키당 분당 60회 요청.
지갑 충전 방식 결제
청구서나 구독 없음 — 주문 및 환불은 발생 즉시 잔액에 반영됩니다.
안정적인 오류 코드
모든 오류는 통합에서 신뢰할 수 있게 사용할 수 있는 표준화된 JSON 코드를 반환합니다.
자주 묻는 질문
VRNUM API를 통해 OTP 번호를 재판매할 수 있나요?
예. otp-catalog 및 otp-numbers 엔드포인트는 귀하의 재판매 가격만 반환합니다. 서비스 및 국가별로 자체 마진을 설정하세요 — 고객은 VRNUM의 내부 비용을 절대 볼 수 없습니다.
OTP 코드가 도착하지 않으면 어떻게 되나요?
아직 대기 중인 활성화에 대해 POST /otp-numbers/:id/cancel을 호출하면 지갑에 전액 환불됩니다. 먼저 재전송 엔드포인트를 호출할 수도 있습니다.
API를 통해 OTP 활성화는 얼마나 오래 유효합니까?
각 활성화는 생성 시점부터 20분 동안 유효합니다. 코드가 도착하지 않으면 만료 전에 취소하여 전액 환불을 받으십시오.
재시도 시 고객에게 이중 청구를 피하려면 어떻게 해야 합니까?
POST /otp-numbers에 Idempotency-Key 헤더를 보내십시오. 동일한 키로 동일한 요청을 재시도하면 새 주문을 생성하지 않고 원래 주문이 반환됩니다.
폴링 대신 실시간 배달 이벤트를 받을 수 있습니까?
예. 웹훅 엔드포인트를 등록하고 이벤트가 발생하는 즉시 서명된 otp.completed 이벤트를 받으십시오.
API를 통해 어떤 서비스가 지원됩니까?
WhatsApp, Telegram, Google, Instagram, Facebook, Discord 등 80개 이상의 서비스를 지원합니다. 실시간 목록은 GET /otp-catalog를 호출하세요.