Elegir un idioma

API para desarrolladores

Compra números desde tu propio software con claves de API, descuentos mayoristas, webhooks firmados y un endpoint compatible con sms-activate.

5 guías · 4 respuestas rápidas

Guías

  • Inicio rápido de la API para desarrolladores Compra números y lee códigos desde tu propio software. Crea una clave, consulta precios, compra un número, espera el SMS y termina, paso a paso. 4 min de lectura
  • Claves de API y seguridad Ámbitos, listas de IP permitidas, límites de gasto diario, caducidad, rotación sin cortes y qué hacer si se filtra una clave. 3 min de lectura
  • Precios mayoristas y niveles por volumen La API vende a los mismos precios que la app, menos tu descuento mayorista: un nivel por volumen según tu gasto de 30 días o un descuento fijo de revendedor. 3 min de lectura
  • Webhooks Recibe en tu servidor los eventos de activación en tiempo real, verifica la cabecera SmsGrab-Signature y entiende los reintentos, los envíos de prueba y la desactivación automática. 4 min de lectura
  • El endpoint compatible con sms-activate Sigue usando bots y paneles hechos para el protocolo sms-activate cambiando una sola URL. Acciones compatibles, formatos de identificadores y diferencias que conviene conocer. 2 min de lectura

Respuestas rápidas

¿Cuánto cuesta la API para desarrolladores?

No hay suscripción: pagas por número con tu saldo habitual. Cada número cuesta lo mismo que en la app, menos tu descuento mayorista. Los niveles por volumen bajan el precio en cuanto tu gasto neto de los últimos 30 días, en todos los canales, supera un umbral, y los revendedores aprobados tienen un descuento fijo; siempre se aplica el mayor de los dos. Los números sin código se reembolsan como siempre. Consulta Precios mayoristas y niveles por volumen.

Abrir esta respuesta en su propia página
¿Cuántas peticiones puedo enviar a la API?

Por defecto, cada clave puede enviar 600 peticiones y hacer 60 compras por minuto, y todas las claves de una cuenta juntas 3.000 peticiones por minuto. Por cuenta pueden esperar un código hasta 100 números a la vez, y por clave puede haber hasta 20 peticiones en espera (?wait=) abiertas. Si superas un límite, recibes 429 RATE_LIMITED con una cabecera Retry-After; además, cada respuesta incluye cabeceras RateLimit-*. Consulta Inicio rápido de la API para desarrolladores.

Abrir esta respuesta en su propia página
Se ha filtrado mi clave de API. ¿Qué hago?

Actúa enseguida: revoca la clave en Cuenta > Desarrolladores, o rótala con un periodo de transición de 0 horas. Revocar es inmediato y no pide contraseña. Después revisa el registro de peticiones de la clave y tu Billetera por si hay actividad que no reconoces, y crea una clave nueva con lista de IP permitidas y límite de gasto diario. Guarda las claves solo en servidores, nunca en apps ni páginas web. Consulta Claves de API y seguridad.

Abrir esta respuesta en su propia página
¿Funcionan con SmsGrab las herramientas hechas para sms-activate?

En la mayoría de los casos, sí. Apunta la herramienta a https://smsgrab.com/api/stubs/handler_api.php y usa tu clave de API de SmsGrab como api_key. Se admiten las acciones estándar, desde getBalance y getNumber hasta setStatus y getStatus. Los importes están en dólares estadounidenses a tu precio con el descuento mayorista incluido, no en rublos, y los alquileres no están disponibles. Consulta El endpoint compatible con sms-activate.

Abrir esta respuesta en su propia página

Otros temas

¿Sigues necesitando ayuda?

Escríbenos. Respondemos a todos los mensajes, normalmente en pocas horas.

O escríbenos a support@smsgrab.com