API de números virtuales
para revendedores
Proporcione números de teléfono virtuales dedicados mensuales y anuales mediante programación, establezca su propio precio de reventa y cree su propia marca de verificación por SMS, sin tener una sola tarjeta SIM.
¿Por qué aprovechar la API VRNUM en lugar de las ofertas de sus propios operadores?
Obtener números reales de operadores de telefonía móvil directamente significa contratos de SIM, hardware, gastos generales de cumplimiento y meses de tiempo de espera antes de poder vender una sola verificación. La API VRNUM se salta todo eso.
Obtiene acceso instantáneo a un inventario en vivo de números virtuales mensuales y anuales en más de 50 países, con su propio margen integrado en cada precio que devuelve la API. Tus clientes solo ven tu marca y tu precio.
De la clave API a tu primera venta
Cuatro pasos para una integración de revendedor que funcione.
Generar una clave API
Cree una cuenta VRNUM gratuita y genere una clave desde la pestaña Desarrolladores. Una clave activa por cuenta.
Financia tu billetera
Recarga con criptomonedas. Cada pedido se deduce de su saldo: sin facturas ni facturación manual.
leer el catalogo
Llame a GET /catalog para conocer los países activos, los términos de suscripción y los precios. Agregue su marcado antes de mostrarlos.
Provisión bajo demanda
PUBLICAR /números con una clave de idempotencia para asignar un número al instante, luego sondear o utilizar webhooks para la entrega.
Proporcione un número en una solicitud
clientReference es su propia identificación opaca: adjúntela para conciliar los pedidos con sus 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"
}'Todo lo que necesita para ejecutar el ciclo de vida completo del pedido
Catálogo, aprovisionamiento, recuperación de SMS, renovación, renovación automática y webhooks: una API JSON coherente.
/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/balanceLos documentos completos de solicitud/respuesta y sus claves se encuentran en sutablerodespués de iniciar sesión.
¿Quién construye sobre la API de números virtuales?
Cualquier empresa que necesite un suministro de números de teléfono reales sin poseer infraestructura de telecomunicaciones.
Revendedores de telecomunicaciones
Lanza tu propia marca de números como servicio además del inventario de operadores en vivo sin un solo contrato de SIM.
Fundadores de SaaS y aplicaciones
Agregue el aprovisionamiento de números de teléfono al flujo de incorporación o verificación de su producto con algunas llamadas API.
Agencias de desarrollo
Envíe funciones de aprovisionamiento de números para aplicaciones de clientes sin negociar sus propios acuerdos con el operador.
Equipos de control de calidad y automatización
Proporcione números desechables pero reales a pedido para conjuntos de pruebas de registro y verificación automatizados.
Creado para producción, no para una demostración
Claves de idempotencia
Vuelva a intentarlo de forma segura en los tiempos de espera: la misma clave de idempotencia siempre devuelve el orden original, nunca un duplicado.
Webhooks firmados
Eventos number.provisioned, number.provisioning_failed y sms.received, firmados con X-VRNUM-Signature (HMAC-SHA256).
Reintentos automáticos
Las entregas fallidas de webhook se reintentan en un cronograma de espera (5 min, 30 min, 2 h, 6 h, 24 h) antes de darnos por vencidos.
Límites de tarifas transparentes
60 solicitudes/minuto por clave con encabezados X-RateLimit-* en cada respuesta, para que pueda retroceder de manera predecible.
Facturación financiada con billetera
Sin facturas ni suscripciones para el acceso a la API: los pedidos se deducen de su saldo en el momento en que se realizan correctamente.
Códigos de error estables
Cada error devuelve un código JSON normalizado que su integración puede activar de manera confiable, no solo un estado HTTP.
Preguntas frecuentes
¿Puedo revender números virtuales VRNUM con mi propia marca?
Sí. La API solo devuelve su precio de reventa: sus clientes nunca ven el costo interno de VRNUM ni la fuente del operador subyacente. Usted establece su propio margen de beneficio por país y servicio.
¿Cómo obtengo acceso a la API de números virtuales?
Cree una cuenta VRNUM gratuita, abra la pestaña Desarrolladores y genere una clave API. Sin espera de aprobación, sin tarifa API mensual: solo paga con el saldo de su billetera cuando proporciona un número.
¿Qué autenticación utiliza la API?
Autenticación de token de portador. Envíe su clave API como Autorización: encabezado de portador o un encabezado X-API-Key en cada solicitud.
¿Existen riesgos de pedidos duplicados si una solicitud caduca?
No. Cada punto final de compra acepta un encabezado Idempotency-Key: vuelva a intentar la misma solicitud con la misma clave y obtendrá el pedido original en lugar de un cargo duplicado.
¿Cómo recibo una notificación cuando un número está listo o llega un SMS?
Registre una URL de webhook desde la pestaña Desarrolladores. VRNUM envía eventos firmados (number.provisioned, number.provisioning_failed, sms.received) a su punto final, reintentando las entregas fallidas automáticamente.
¿Cuáles son los límites de tasa API?
60 solicitudes por clave por minuto. Cada respuesta incluye encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para que pueda retroceder limpiamente.
Comience a revender números virtuales hoy
Cree una cuenta gratuita, genere su clave API y proporcione su primer número virtual en minutos.