API de Número Virtual
para Revendedores
Forneça números de telefone virtuais dedicados mensal e anualmente de forma programática, defina seu próprio preço de revenda e construa sua própria marca de verificação por SMS — sem possuir um único SIM.
Por que construir sobre a API VRNUM em vez de seus próprios acordos com operadoras
Obter números reais de operadoras móveis diretamente significa contratos de SIM, hardware, encargos de conformidade e meses de prazo antes de você poder vender uma única verificação. A API VRNUM elimina tudo isso.
Você obtém acesso instantâneo a um inventário ativo de números virtuais mensais e anuais em mais de 50 países, com sua própria margem incorporada em cada preço que a API retorna. Seus clientes só veem sua marca e seu preço.
Da chave da API à sua primeira venda
Quatro etapas para uma integração de revendedor funcional.
Gerar uma chave de API
Crie uma conta VRNUM gratuita e gere uma chave na aba Desenvolvedores. Uma chave ativa por conta.
Financie sua carteira
Recarregue com criptomoeda. Cada pedido é deduzido do seu saldo — sem faturas, sem cobrança manual.
Leia o catálogo
Use GET /catalog para obter países ativos, condições de assinatura e preços. Adicione sua margem antes de exibi-los.
Provisionamento sob demanda
Use POST /numbers com uma Idempotency-Key para atribuir um número instantaneamente, depois consulte ou use webhooks para entrega.
Provisionar um número em um único pedido
clientReference é seu próprio ID opaco — anexe-o para reconciliar pedidos com seus registros internos de clientes.
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"
}'Tudo o que você precisa para gerenciar o ciclo completo de pedidos
Catálogo, provisionamento, recuperação de SMS, renovação, renovação automática e webhooks — uma API JSON consistente.
/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/balanceDocumentação completa de requisições/respostas e suas chaves ficam no seudashboardapós o login.
Quem constrói na API de número virtual
Qualquer negócio que precise de um fornecimento de números de telefone reais sem possuir infraestrutura de telecom.
Revendedores de telecom
Lance sua própria marca de números como serviço sobre o inventário ao vivo de operadoras sem um único contrato de SIM.
Fundadores de SaaS e aplicativos
Adicione o provisionamento de números de telefone ao fluxo de integração ou verificação do seu produto com algumas chamadas de API.
Agências de desenvolvimento
Implemente recursos de provisionamento de números para aplicativos de clientes sem negociar seus próprios contratos com operadoras.
Equipes de QA e automação
Provisione números descartáveis, mas reais, sob demanda para conjuntos de testes automatizados de registro e verificação.
Construído para produção, não para demonstração
Chaves de idempotência
Tente novamente com segurança em caso de timeouts — a mesma Idempotency-Key sempre retorna o pedido original, nunca um duplicado.
Webhooks assinados
eventos number.provisioned, number.provisioning_failed e sms.received, assinados com X-VRNUM-Signature (HMAC-SHA256).
Tentativas automáticas
Falhas na entrega de webhooks são re-tentadas em uma programação de backoff (5min, 30min, 2h, 6h, 24h) antes de desistirmos.
Limites de taxa transparentes
60 solicitações/minuto por chave com cabeçalhos X-RateLimit-* em todas as respostas, para que você possa reduzir o ritmo de forma previsível.
Faturamento via carteira
Sem faturas ou assinaturas para acesso à API — os pedidos deduzem do seu saldo no instante em que são bem-sucedidos.
Códigos de erro estáveis
Todo erro retorna um código JSON normalizado que sua integração pode usar de forma confiável, e não apenas um status HTTP.
Perguntas frequentes
Posso revender números virtuais VRNUM sob minha própria marca?
Sim. A API retorna apenas o seu preço de revenda — seus clientes nunca veem o custo interno da VRNUM ou a operadora subjacente. Você define sua própria margem por país e serviço.
Como obtenho acesso à API de números virtuais?
Crie uma conta gratuita na VRNUM, abra a aba Desenvolvedores e gere uma chave de API. Não há espera por aprovação, nem taxa mensal de API — você paga apenas a partir do saldo da sua carteira ao provisionar um número.
Qual autenticação a API utiliza?
Autenticação via token Bearer. Envie sua chave de API como cabeçalho Authorization: Bearer ou como cabeçalho X-API-Key em cada requisição.
Pedidos duplicados são um risco se uma requisição expirar?
Não. Cada endpoint de compra aceita um cabeçalho Idempotency-Key — refaça a mesma requisição com a mesma chave e você receberá o pedido original em vez de uma cobrança duplicada.
Como sou notificado quando um número está pronto ou chega um SMS?
Registre uma URL de webhook na aba Desenvolvedores. A VRNUM envia eventos assinados (number.provisioned, number.provisioning_failed, sms.received) para seu endpoint, tentando automaticamente entregas que falharem.
Quais são os limites de taxa da API?
60 solicitações por chave por minuto. Cada resposta inclui os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset para que você possa reduzir a frequência de forma adequada.
Comece a revender números virtuais hoje
Crie uma conta gratuita, gere sua chave de API e disponibilize seu primeiro número virtual em minutos.