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/api/app/notifications/send \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"transactionId": "welcome-001",
"application": "demo",
"region": "ES",
"language": "es",
"notificationType": "onboard",
"notificationSubtype": "welcome",
"recipients": [{ "channel": "sms", "recipient": "+34612345678" }],
"templateVariables": [{ "firstName": "Alex" }]
}'
var client = new OneSend2UClient(new OneSend2UClientOptions {
BaseUrl = "https://api.onesend2u.com",
ApiKey = "YOUR_API_KEY",
TenantId = "YOUR_TENANT_ID"
});
await client.Notifications.SendAsync(new SendNotificationRequest {
TransactionId = "welcome-001",
Application = "demo",
Region = "ES",
Language = "es",
NotificationType = "onboard",
NotificationSubtype = "welcome",
Recipients = [new() { Channel = Channel.Sms, Recipient = "+34612345678" }],
TemplateVariables = [new() { ["firstName"] = "Alex" }]
});
// Node.js SDK — coming soon. Use fetch in the meantime:
await fetch('https://api.onesend2u.com/api/app/notifications/send', {
method: 'POST',
headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
transactionId: 'welcome-001',
application: 'demo',
region: 'ES', language: 'es',
notificationType: 'onboard', notificationSubtype: 'welcome',
recipients: [{ channel: 'sms', recipient: '+34612345678' }],
templateVariables: [{ firstName: 'Alex' }]
})
});
# Python SDK — coming soon. Use requests in the meantime:
import requests
requests.post(
"https://api.onesend2u.com/api/app/notifications/send",
headers={"X-API-Key": "YOUR_API_KEY"},
json={
"transactionId": "welcome-001",
"application": "demo",
"region": "ES", "language": "es",
"notificationType": "onboard", "notificationSubtype": "welcome",
"recipients": [{"channel": "sms", "recipient": "+34612345678"}],
"templateVariables": [{"firstName": "Alex"}]
}
)
Experiencia moderna de desarrollador: SDK tipado, webhooks firmados, logs de API consultables y un sandbox en camino — para que te centres en tu producto, no en nuestra fontanería.
Validación en compilación, IntelliSense y cero boilerplate HTTP.
Excepciones tipadas de rate-limit exponen cuota restante y retry-after, para que tu backoff sea preciso.
Cada entrega de webhook lleva firma HMAC-SHA256. Valida la firma con el helper del SDK en una línea.
Cada envío devuelve un transaction ID que conecta la petición, la respuesta de la API y la entrega en cada canal.
Pruebas end-to-end sin proveedores reales ni cargos.
Desde el registro hasta tu primer mensaje en menos de 5 minutos.
Regístrate en OneSend2U y genera tu API key desde el portal. Tu clave otorga acceso a todos los endpoints con permisos basados en roles.
Conecta tu proveedor de mensajería preferido (Twilio, Infobip o SMTP). El enrutamiento multi-proveedor está integrado para máxima flexibilidad.
Haz tu primera llamada API para enviar un SMS, Email o mensaje de WhatsApp. Usa plantillas con variables para contenido dinámico y personalizado.
Endpoints principales de la API de OneSend2U. Todos se autentican con el header X-API-Key y soportan versionado mediante el query string api-version.
| Método | Endpoint | Descripción |
|---|---|---|
| POST | /api/app/notifications/send |
Envía una notificación (SMS, Email, WhatsApp, etc.) |
| GET | /api/app/notifications |
Lista notificaciones con filtros y paginación |
| GET | /api/app/notifications/{id} |
Obtén el detalle y estado de entrega de una notificación |
| GET | /api/app/messages |
Lista mensajes (entregas por canal con estado) |
| GET | /api/app/templates |
Lista las plantillas |
| POST | /api/app/webhooks |
Registra un webhook para callbacks de eventos |
| GET | /api/app/notification-api-logs |
Consulta los logs de llamadas API por transaction ID |
Recibe notificación en el momento en que un mensaje cambia de estado — entrega, fallo o acción del usuario.
// Ejemplo de payload POST de webhook
// HTTP POST to your registered URL
// Headers:
// X-OneSend2U-Webhook-Id: <guid>
// X-OneSend2U-Webhook-Timestamp: <unix-seconds>
// X-OneSend2U-Webhook-Signature: v1=<hmac-sha256>
{
"transactionId": "tx-abc-001",
"regionCode": "ES",
"applicationCode": "shop",
"notificationTypeCode": "orders",
"notificationSubtypeCode": "confirmation",
"channelTypeCode": "sms",
"messageProviderStateCode": "delivered",
"MessageProcessState": "Delivered"
}
Intégrate con las herramientas y lenguajes que ya usas.
Paquete NuGet OneSend2U.Sdk con clientes tipados, async/await, integración con DI, políticas de reintento con Polly y verificación de firma de webhooks integrada.
dotnet add package OneSend2U.Sdk
Navega endpoints y esquemas en tu navegador, con prueba opcional usando tu propia API key.
Descarga la especificación completa para generar código cliente en cualquier lenguaje usando herramientas como NSwag, AutoRest u openapi-generator.
Explora nuestros repositorios de SDKs, apps de ejemplo e integraciones de referencia.
Paquete npm con definiciones TypeScript y API basada en Promesas.
Paquete pip con soporte async y manejo integral de errores.
Colección preconfigurada con variables de entorno y peticiones de ejemplo.
Prueba tu integración sin riesgo antes de ir a producción.
El sandbox replica la API de producción exactamente. Tu código de integración funciona en ambos entornos sin cambios.
El sandbox usa sus propias credenciales de API, así el tráfico de prueba nunca sale desde tus claves de producción.
Itera sobre plantillas en sandbox sin esperar la aprobación del proveedor (Meta WhatsApp, etc.). Prueba el copy y el renderizado al instante.
Envía mensajes de prueba ilimitados sin coste. Los mensajes en sandbox son simulados y nunca llegan a destinatarios reales.
Provoca escenarios de error específicos (número inválido, timeout de proveedor, límite de tasa) para probar tu manejo de errores.
Recibe callbacks webhook simulados para todos los estados de entrega y valida tus manejadores de eventos.