가상 번호 API
리셀러용
전용 월간 및 연간 가상 전화번호를 프로그램 방식으로 제공하고, 자체 재판매 가격을 설정하며, 단 하나의 SIM도 소유하지 않고 SMS 인증 브랜드를 구축하세요.
왜 자체 통신사 계약 대신 VRNUM API를 사용할까
실제 모바일 통신사 번호를 직접 확보하려면 SIM 계약, 하드웨어, 규제 준수 부담과 함께 단일 인증을 판매하기 전까지 몇 달의 대기 시간이 필요합니다. VRNUM API는 이러한 모든 과정을 건너뜁니다.
50개 이상의 국가에 걸친 월간 및 연간 가상 번호를 실시간으로 제공받으며, API가 반환하는 모든 가격에는 귀하의 마진이 포함됩니다. 귀하의 고객은 항상 귀하의 브랜드와 가격만 보게 됩니다.
API 키에서 첫 판매까지
작동하는 리셀러 통합을 위한 네 단계.
API 키 생성
무료 VRNUM 계정을 만들고 개발자 탭에서 키를 생성하세요. 계정 당 하나의 활성 키만 가능합니다.
지갑 충전
암호화폐로 충전하세요. 모든 주문은 잔액에서 차감됩니다 — 청구서나 수동 결제는 필요 없습니다.
카탈로그 읽기
GET /catalog를 호출하여 실시간 국가, 구독 조건 및 가격을 확인하세요. 표시하기 전에 마크업을 추가하세요.
요청 시 프로비저닝
POST /numbers와 Idempotency-Key를 사용하여 번호를 즉시 할당한 후, 전달을 위해 폴링하거나 웹훅을 사용하세요.
한 번의 요청으로 번호 프로비저닝
clientReference is your own opaque ID — attach it to reconcile orders against your internal customer records.
curl -X POST https://vrnum.com/api/v1/numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-8841" \
-d '{
"route": "<from catalog>",
"countryCode": "US",
"subscriptionOption": "month",
"clientReference": "order-8841"
}'Everything you need to run the full order lifecycle
Catalog, provisioning, SMS retrieval, renewal, auto-renew, and webhooks — one consistent JSON API.
/api/v1/catalog/api/v1/numbers/api/v1/numbers/api/v1/numbers/:id/api/v1/numbers/:id/sms/api/v1/numbers/:id/renew/api/v1/numbers/:id/autorenew/api/v1/webhook/api/v1/balanceFull request/response docs and your keys live in your dashboard after you sign in.
Who builds on the virtual number API
Any business that needs a supply of real phone numbers without owning telecom infrastructure.
Telecom resellers
Launch your own numbers-as-a-service brand on top of live carrier inventory without a single SIM contract.
SaaS 및 앱 창업자
몇 번의 API 호출만으로 제품 온보딩 또는 인증 흐름에 전화번호 제공 기능을 추가하세요.
개발 에이전시
자체 통신사 계약을 체결하지 않고도 클라이언트 앱용 번호 제공 기능을 배포하세요.
QA 및 자동화 팀
자동 등록 및 인증 테스트 스위트를 위해 필요할 때마다 일회용이지만 실제 번호를 제공하세요.
데모용이 아닌 실제 프로덕션용으로 제작
Idempotency 키
타임아웃 시 안전하게 재시도 — 동일한 Idempotency-Key는 항상 원래 주문을 반환하며, 중복은 절대 생성되지 않습니다.
서명된 웹훅
number.provisioned, number.provisioning_failed, 및 sms.received 이벤트는 X-VRNUM-Signature(HMAC-SHA256)로 서명됩니다.
자동 재시도
실패한 웹훅 전송은 포기하기 전까지 백오프 일정(5분, 30분, 2시간, 6시간, 24시간)에 따라 재시도됩니다.
투명한 속도 제한
모든 응답에는 X-RateLimit-* 헤더가 포함되어 있으며, 키당 1분에 60개의 요청 제한이 적용되므로 예측 가능하게 백오프할 수 있습니다.
지갑 기반 결제
API 접근을 위한 인보이스나 구독은 없으며, 주문이 성공하는 순간 잔액에서 차감됩니다.
안정적인 오류 코드
모든 오류는 HTTP 상태 코드뿐만 아니라 통합에서 신뢰할 수 있게 전환할 수 있는 표준화된 JSON 코드를 반환합니다.
자주 묻는 질문
VRNUM 가상 번호를 제 브랜드로 재판매할 수 있나요?
예. API는 귀하의 재판매 가격만 반환합니다 — 고객은 VRNUM의 내부 비용이나 기본 통신사 출처를 절대 볼 수 없습니다. 국가와 서비스별로 자체 마진을 설정할 수 있습니다.
가상 번호 API에 어떻게 접근하나요?
무료 VRNUM 계정을 생성하고, 개발자(Developers) 탭을 열어 API 키를 생성하세요. 승인 대기 없음, 월간 API 요금 없음 — 번호를 프로비저닝할 때만 지갑 잔액에서 비용이 차감됩니다.
API는 어떤 인증 방식을 사용하나요?
Bearer 토큰 인증입니다. API 키를 매 요청 시 Authorization: Bearer 헤더 또는 X-API-Key 헤더로 보내세요.
요청이 시간 초과되면 중복 주문 위험이 있나요?
아니요. 모든 구매 엔드포인트는 Idempotency-Key 헤더를 지원합니다 — 동일한 키로 같은 요청을 재시도하면 중복 요금 없이 원래 주문이 반환됩니다.
번호가 준비되거나 SMS가 도착했을 때 알림을 받으려면 어떻게 하나요?
개발자(Developers) 탭에서 웹훅 URL을 등록하세요. VRNUM은 서명된 이벤트(number.provisioned, number.provisioning_failed, sms.received)를 엔드포인트로 POST하며, 실패한 전송은 자동으로 재시도됩니다.
API 속도 제한은 무엇인가요?
키당 분당 60회 요청입니다. 모든 응답에는 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 헤더가 포함되어 있어 정상적으로 요청을 줄일 수 있습니다.