Referencia de API

Construye con SMSBulk

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

Abrir referencia de API Obtener clave API

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.

Obtén tu clave API

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

Abrir panel

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" }

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": "TR"
  }'

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

Espera el SMS

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

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.

Referencias

Guía de migración de API heredada

Documentación de compatibilidad directa para mover integraciones de bot existentes. Lista de acciones, IDs de país, códigos de error.

Errores y Rate Limits

Referencia completa de códigos de error, políticas de rate limit, estrategias de reintento y guía de idempotencia.

¿Listo para producción?

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

Abrir referencia de API Empezar