Onurix
- 08/08/2025
- por Onurix
- Etiqueta : FAQ Integraciones
En el mundo del desarrollo de software moderno, la velocidad de integración es clave para el éxito de cualquier proyecto. Los desarrolladores necesitan herramientas que les permitan probar, validar y documentar APIs de forma rápida y eficiente. La Colección Postman para servicios Onurix es la solución perfecta para integrar servicios de comunicación multicanal en aplicaciones sin perder tiempo en configuraciones complejas.
¿Qué es la Colección Postman para servicios Onurix?
La Colección Postman para servicios Onurix es un conjunto completo y documentado de más de 23 endpoints organizados que te permite:
- Probar la API sin escribir una sola línea de código.
- Validar credenciales y permisos de forma inmediata
- Entender la estructura de cada petición y respuesta
- Generar código automáticamente en más de 20 lenguajes de programación
- Documentar integraciones para el equipo de desarrollo
- Acelerar el desarrollo con ejemplos pre-configurados
Canales de Comunicación Disponibles
La colección incluye endpoints para los siguientes servicios:
- SMS: Envío de mensajes de texto y códigos 2FA
- WhatsApp: Mensajes con plantillas, imágenes, documentos, videos y ubicaciones
- Llamadas de Voz: Mensajes automáticos con Text-to-Speech (TTS)
- Gestión de Contactos: CRUD completo de contactos y grupos
- Acortador de URLs: Genera enlaces cortos con estadísticas de clicks
- Funciones Generales: Balance, verificación de estado, bloqueo de números
Ventajas de Usar la Colección Postman
Para Desarrolladores
- Reducción del 80% en tiempo de integración: No se requiere leer documentación extensa, todos los ejemplos están listos para usar
- Validación en tiempo real: Pruebe cada endpoint y verifique respuestas al instante
- Generación automática de código: Exporte código en PHP, Python, Node.js, Java, Go, C# y más
- Variables de entorno: Gestione múltiples credenciales (desarrollo, producción) sin cambiar la colección
- Sin errores de sintaxis: Los ejemplos están pre-validados y funcionan de inmediato
Para Equipos Técnicos
- Documentación viva: La colección sirve como documentación interactiva que siempre está actualizada
- Onboarding rápido: Nuevos desarrolladores pueden empezar a trabajar en 5 minutos
- Pruebas consistentes: Estandariza cómo el equipo prueba la API
- Colaboración: Comparta la colección con el equipo y sincronice cambios automáticamente
Para Empresas
- Menor costo de integración: Reduce horas de desarrollo y consultoría técnica
- Prototipado rápido: Valida casos de uso antes de escribir código de producción
- Escalabilidad: Facilita agregar nuevos canales de comunicación a las aplicaciones
- ROI inmediato: Comience a enviar mensajes en minutos, no en semanas
Estructura de la Colección
La colección está organizada en 6 categorías principales con más de 23 endpoints:
+------------------------+------------+--------------------------------------------------+-----------------------------------------+
| Categoría | Endpoints | Descripción | Casos de Uso |
+------------------------+------------+--------------------------------------------------+-----------------------------------------+
| Servicio de SMS | 2 | Envío de SMS simples y códigos 2FA | Notificaciones, alertas, autenticación |
| WhatsApp | 7 | Mensajes con plantillas, multimedia o texto libre| Marketing, soporte, transacciones |
| Llamadas de Voz | 2 | Llamadas automáticas con voz TTS y 2FA por voz | Recordatorios, verificación, emergencias|
| Contactos y Grupos | 9 | CRUD de contactos, grupos y asociaciones | Gestión de audiencias, segmentación |
| Acortador de URLs | 2 | Creación de enlaces cortos y métricas detalladas | Tracking, análisis, campañas |
| Funciones Generales | 3 | Consultas de balance, estado, bloqueo de números | Administración, monitoreo |
+------------------------+------------+--------------------------------------------------+-----------------------------------------+
Cómo Usar la Colección Postman
Método 1: Importación Directa por URL (Recomendado)
La forma más rápida de comenzar, sin necesidad de descargar archivos:
-
Abra Postman y haga clic en “Import” en la esquina superior izquierda
-
Seleccione la pestaña “Link” y pegue la siguiente URL:
https://raw.githubusercontent.com/onurixlatam/postman/main/Onurix-API.postman_collection.json -
Haga clic en “Continue” y luego en “Import”
-
Configure las variables de autenticación:
La colección utiliza dos tipos de variables:
Variables de Vault (Autenticación)
Estas variables almacenan sus credenciales de forma segura:
{{vault:onurix_client_id}}- Client ID de Onurix{{vault:onurix_key}}- API Key de Onurix
Para configurarlas:
- Ir a Settings > Vault en Postman
- Agregue
onurix_client_idcon tu Client ID - Agregue
onurix_keycon tu API Key - (Obtenga sus credenciales en Onurix Seguridad API)
Variables de Colección (Parámetros de prueba)
Estas variables facilitan las pruebas y son editables en cada request:
phone- Número de teléfono para pruebas (ej: 525512345678)2fa-app-name- Nombre de tu aplicación para 2FAtemplate-id- ID de plantilla de WhatsApp- Y otras variables personalizables según el endpoint
Para editarlas:
- Haga clic derecho en la colección > Edit
- Ir a la pestaña Variables
- Defina los valores que usará en las pruebas
-
¡Listo para probar! Seleccione cualquier endpoint y haga clic en “Send”
Método 2: Importación desde Archivo Local
Si prefiere trabajar con el repositorio completo:
-
Descarga la colección:
git clone https://github.com/onurixlatam/postman.git -
Abra Postman y haga clic en “Import”
-
Arrastre el archivo
Onurix-API.postman_collection.jsono selecciónelo manualmente -
Configure las variables siguiendo los mismos pasos del Método 1
Método 3: Quick Start (5 minutos)
Para usuarios que quieren empezar inmediatamente, sigua la Guía de Inicio Rápido que incluye:
- Configuración paso a paso de credenciales
- El primer envío de SMS en 1 minuto
- Ejemplos de WhatsApp con plantillas
- Gestión básica de contactos
Casos de Éxito y Aplicaciones
E-commerce y Retail
- Confirmaciones de pedidos vía WhatsApp
- Alertas de envío por SMS
- Recordatorios de carritos abandonados
- Notificaciones de ofertas personalizadas
Servicios Financieros
- Autenticación de dos factores (2FA) por SMS o voz
- Alertas de transacciones
- Recordatorios de pagos
- Confirmación de operaciones sensibles
Salud y Medicina
- Recordatorios de citas médicas
- Resultados de laboratorio por WhatsApp
- Alertas de medicación
- Comunicación con pacientes
Educación y Academia
- Notificaciones de calificaciones
- Recordatorios de clases
- Comunicación padres-escuela
- Alertas de eventos importantes
Seguridad y Mejores Prácticas
Gestión de Credenciales
- NUNCA incluya sus credenciales en el código fuente
- Use variables de entorno de Postman
- Considere usar Vault de Postman para credenciales sensibles
- Rote sus API keys periódicamente
Control de Acceso
- Autorice las IPs de sus servidores en el panel de Onurix
- Implemente rate limiting en la aplicación
- Monitoree el uso de la API regularmente
- Bloquee números sospechosos usando el endpoint
/api/v1/block-phone
Comparativa: Con y Sin Colección Postman
| Aspecto | Sin Colección | Con Colección Onurix |
| ----------------------------- | -------------------------- | ---------------------------------- |
| Tiempo de primera integración | 4-8 horas | 5-15 minutos |
| Documentación de endpoints | Manual, propensa a errores | Automática y actualizada |
| Pruebas de API | Requiere escribir código | Click y prueba instantánea |
| Onboarding de desarrolladores | 1-2 días | 15 minutos |
| Generación de código | Manual | Automática en 20+ lenguajes |
| Mantenimiento | Alto | Bajo (actualizaciones automáticas) |
Recursos Adicionales
Documentación Técnica
Soporte y Comunidad
- Email: soporte@onurix.com
- GitHub Issues: Reportar problemas
Preguntas Frecuentes
¿La colección Postman es gratuita?
Sí, la colección es completamente gratuita y de código abierto (Licencia MIT). Solo paga por el uso del servicio según el paquete adquirido.
¿Necesito conocimientos avanzados de programación?
No. Postman está diseñado para que cualquier persona con conocimientos básicos de APIs pueda usarlo. La colección incluye ejemplos pre-configurados.
¿Puedo usar la colección en mi equipo?
Absolutamente. Puede compartir la colección con el equipo y sincronizarla usando Postman Workspaces.
¿Qué pasa si un endpoint no funciona?
Primero verifique sus credenciales y que su IP esté autorizada. Si el problema persiste, reporta un issue en GitHub.
¿La colección se actualiza automáticamente?
Las actualizaciones se publican en el repositorio de GitHub. Puede sincronizar haciendo git pull o re-importando el archivo JSON.
¿Puedo generar código desde Postman?
Sí. Postman permite generar código en más de 20 lenguajes. Solo haga clic en el botón “Code” (</>) en cualquier request.
¿Cuál es la diferencia entre las variables de Vault y las variables normales?
La colección utiliza dos tipos de variables:
- Variables de Vault (
{{vault:onurix_client_id}}y{{vault:onurix_key}}): Almacenan las credenciales de forma segura y cifrada. Son usadas para autenticación en todos los endpoints. - Variables de Colección (
{{phone}},{{template-id}}, etc.): Son valores personalizables que facilitan las pruebas. Puede editarlas fácilmente en la pestaña Variables de la colección sin comprometer la seguridad de tus credenciales.
Conclusión: Acelera tu Desarrollo con Onurix
La Colección Postman de Onurix no es solo una herramienta de prueba, es su aliado para reducir costos de desarrollo, acelerar el time-to-market y garantizar integraciones exitosas. En un mercado donde la velocidad es ventaja competitiva, contar con herramientas que facilitan la integración es fundamental.
¿Por qué elegir Onurix?
Integración en minutos: No espere semanas para empezar a comunicarse con sus clientes
Soporte técnico en español: Horario extendido y respuesta rápidas
Pricing transparente: Sin costos ocultos ni mínimos de consumo
Comience Hoy Mismo
- Regístrese en Onurix y obténga 10 de créditos gratis
- Importe la colección a Postman usando la URL:
https://raw.githubusercontent.com/onurixlatam/postman/main/Onurix-API.postman_collection.json - Configure sus credenciales en Vault de Postman
- Envíe su primer mensaje en menos de 5 minutos
¿Necesita ayuda? Nuestro equipo está listo para asistirle en cada paso de la integración.