Referencia de API

Construye con SMSBulk

API REST moderna y endpoints compatibles con SMS-Activate. Empieza en minutos.

Dos estilos de API

Elige el formato que se adapte a tu proyecto — ambos respaldados por la misma infraestructura.

API REST moderna

API JSON limpia con especificación OpenAPI. Ideal para nuevas integraciones.

  • Cuerpos de solicitud y respuesta JSON
  • Spec OpenAPI 3.0 en /api/docs
  • Autenticación Bearer token o x-api-key
  • Códigos de estado HTTP estándar
curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

Compatible con API heredada

Compatible con el protocolo estándar de la industria basado en query. Los scripts y bibliotecas de bots existentes funcionan sin cambios de código — solo apunta a nuestra URL base.

  • Protocolo basado en acciones idéntico
  • Formato de respuesta de texto plano
  • Compatible con bibliotecas de bots existentes
  • Mapeo canónico de IDs de país preservado
curl "https://smsbulk.net/stubs/handler_api.php\
?api_key=YOUR_KEY&action=getBalance"
Guía de migración

Inicio Rápido

De cero a tu primer SMS en menos de 5 minutos.

1

Obtén tu clave API

Crea una clave API desde tu panel. Cada usuario puede crear hasta 10 claves.

Abrir panel
2

Prueba la autenticación

Verifica que tu clave funcione consultando el saldo de tu cartera.

curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

# Response:
# { "balance": "10.00", "currency": "USD" }
3

Compra un número

Reserva un número virtual para verificación SMS. El costo se descuenta de tu cartera.

curl -X POST https://smsbulk.net/api/v1/activations \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "US"
  }'

# Response:
# {
#   "id": "cuid_xxx",
#   "phoneNumber": "12025550147",
#   "status": "WAITING",
#   "userCost": "0.50"
# }
4

Espera el SMS

Sondea el endpoint de activación hasta que el estado sea RECEIVED. El código SMS estará en la respuesta.

El contenido de los mensajes, incluido el código, se elimina 30 días después de recibirse; a partir de entonces getStatus devuelve NO_ACTIVATION y v1 devuelve purged: true.

curl https://smsbulk.net/api/v1/activations/cuid_xxx \
  -H "x-api-key: YOUR_KEY"

# Response (when SMS arrives):
# {
#   "id": "cuid_xxx",
#   "smsCode": "123456",
#   "status": "RECEIVED",
#   ...
# }

Autenticación

Tres formas de enviar tu clave API.

Elige el método que se adapte a tu entorno

1. Header (recomendado)

x-api-key: YOUR_API_KEY

Autenticación estándar basada en cabeceras. Funciona con endpoints REST y SMS-Activate.

2. Bearer token

Authorization: Bearer YOUR_API_KEY

Compatible con bibliotecas HTTP que usan Authorization por defecto.

3. Query string

?api_key=YOUR_API_KEY

Requerido para el endpoint de compatibilidad /stubs/handler_api.php.

Mantén tus claves en secreto

Nunca subas claves API a repositorios públicos ni las expongas en el cliente. Cada clave tiene cuota diaria — rótala de inmediato si se compromete.

¿Listo para producción?

Abre la referencia API interactiva y prueba cada endpoint en vivo desde tu navegador.