Hub de desarrolladores

Construye con OneSend2U

API RESTful. Especificación OpenAPI 3.0. Entorno sandbox. Envía tu primer mensaje en menos de 5 minutos.

curl -X POST https://api.onesend2u.com/v1/notifications \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "sms",
    "to": "+34612345678",
    "template": "welcome_v1",
    "variables": {"name": "Alex"}
  }'

Comienza en 3 pasos

Desde el registro hasta tu primer mensaje en menos de 5 minutos.

1

Obtén tu API key

Regístrate en OneSend2U y genera tu API key desde el panel. Tu clave otorga acceso a todos los endpoints con permisos basados en roles.

2

Configura un proveedor

Conecta tu proveedor de mensajería preferido (Twilio, Infobip o SMTP). El enrutamiento multi-proveedor está integrado para máxima flexibilidad.

3

Envía un mensaje

Haz tu primera llamada API para enviar un SMS, Email o mensaje de WhatsApp. Usa plantillas con variables para contenido dinámico y personalizado.

Referencia API

Endpoints principales de la API de OneSend2U. Todos los endpoints requieren autenticación Bearer token.

Método Endpoint Descripción
POST /v1/notifications Enviar una nueva notificación (SMS, Email o WhatsApp)
GET /v1/notifications/{id} Obtener detalles de notificación y estado de entrega
GET /v1/notifications Listar notificaciones con filtros y paginación
POST /v1/templates Crear una nueva plantilla de mensaje
GET /v1/templates Listar plantillas disponibles con historial de versiones
PUT /v1/templates/{id} Actualizar una plantilla existente (crea nueva versión)
GET /v1/providers Listar proveedores de mensajes configurados y su estado
GET /v1/reports/delivery Estadísticas de entrega y analítica por rango de fechas
POST /v1/webhooks Registrar un endpoint webhook para callbacks de eventos

Webhooks en tiempo real

Recibe actualizaciones de estado de entrega en tiempo real mediante callbacks webhook. OneSend2U envía peticiones HTTP POST a tu URL registrada cada vez que cambia el estado de un mensaje — desde encolado hasta entregado, o si falla la entrega.

  • Confirmaciones de entrega en tiempo real
  • Razones de fallo con códigos de error del proveedor
  • Verificación de firma HMAC-SHA256
  • Reintentos automáticos con backoff exponencial
// // Ejemplo de payload POST de webhook
{
  "event": "notification.delivered",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "notificationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "channel": "sms",
    "to": "+34612345678",
    "status": "delivered",
    "provider": "twilio",
    "deliveredAt": "2025-01-15T10:29:58Z"
  },
  "signature": "sha256=a1b2c3..."
}

SDKs y librerías

Intégrate con las herramientas y lenguajes que ya usas.

Disponible ahora

  • REST API con Swagger UI

    Explorador de API interactivo con funcionalidad de prueba. Prueba endpoints directamente desde tu navegador.

  • Especificación OpenAPI 3.0

    Descarga la especificación completa para generar código cliente en cualquier lenguaje usando herramientas como NSwag, AutoRest u openapi-generator.

Próximamente

  • .NET SDK

    Cliente con tipado fuerte, soporte async/await, integración con DI y políticas de reintento.

  • Node.js SDK

    Paquete npm con definiciones TypeScript y API basada en Promesas.

  • Python SDK

    Paquete pip con soporte async y manejo integral de errores.

  • Colección Postman

    Colección preconfigurada con variables de entorno y peticiones de ejemplo.

Entorno sandbox

Prueba tu integración sin riesgo antes de ir a producción.

Paridad completa con la API

El sandbox replica la API de producción exactamente. Tu código de integración funciona en ambos entornos sin cambios.

Sin cargos

Envía mensajes de prueba ilimitados sin coste. Los mensajes en sandbox son simulados y nunca llegan a destinatarios reales.

Simulación de errores

Provoca escenarios de error específicos (número inválido, timeout de proveedor, límite de tasa) para probar tu manejo de errores.

Prueba de webhooks

Recibe callbacks webhook simulados para todos los estados de entrega y valida tus manejadores de eventos.