Dinaup DocsIntegraciones
Los canales para conectar Dinaup con otros sistemas: API REST, webhooks salientes, peticiones HTTP programadas, Zapier, Make y n8n, PG Sync con Power BI, eventos Redis y Cloudflare Workers.
Dinaup se conecta con otros sistemas por varios canales. Cada uno tiene una dirección y un caso: tú preguntas a Dinaup, Dinaup te avisa, o Dinaup replica tus datos donde los lees. Los webhooks y las peticiones programadas los lanza el servidor en segundo plano: Automatizaciones del servidor.
Los canales
| Canal | Dirección | Para qué | Página |
|---|---|---|---|
| API REST | Tú → Dinaup | Leer informes, renderizar documentos, escribir registros y gestionar usuarios finales desde cualquier lenguaje | Referencia de la API REST |
| Webhooks salientes | Dinaup → Tú | Recibir un POST cuando se crea o modifica un registro de una sección | Webhooks salientes |
| Peticiones HTTP programadas | Dinaup → Tú | Que el servidor llame a una URL cada cierto tiempo | Programar peticiones HTTP |
| Zapier, Make y n8n | Las dos | Crear flujos sin programar sobre la API y los webhooks | Zapier, Make y n8n |
| PG Sync y Power BI | Dinaup → PostgreSQL | Tener informes replicados en una base PostgreSQL de solo lectura para BI y SQL | PG Sync y Power BI |
| Eventos Redis | Dinaup → Tu Redis | Recibir cada alta y edición en tiempo real, con caudal alto | Eventos Redis |
| Cloudflare Worker | Delante de la API | Ocultar el token, adaptar formatos y cachear en el borde | Cloudflare Worker |
Si programas en .NET, el SDK .NET cubre lo mismo con clases tipadas y tiene su propia conexión. La API REST es la vía para cualquier otro lenguaje y para las plataformas sin código.
La API REST
Cada empresa tiene su URL: https://<clave-de-conexion>.dinaup.io/api, la que muestra Play en Desarrollo → Inicio. Cada petición lleva Authorization: Bearer <token>, con el token de una clave API marcada como Compatible WebHook.
| Familia | Endpoints |
|---|---|
| Datos | GET /api/whoami · POST /api/reports · POST /api/dynamicdocuments · POST /api/writeoperations |
| Usuarios finales | POST /api/Register · /api/ActivateAccount · /api/RecoverPassword · /api/ChangePassword · /api/Login · /api/Session · /api/Logout · /api/RequestLoginCode · /api/LoginWithCode · /api/GetKV · /api/SetKV |
| Estado | GET /ping · GET /version, fuera de /api y sin token |
Cómo se compone el token y cómo viaja una petición: API REST: cómo funciona. El detalle de cada endpoint: Referencia de la API REST y Usuarios finales: cuentas, sesiones y KV.
Qué canal uso
| Necesitas | Usa |
|---|---|
| Leer o escribir datos desde tu código | API REST, o el SDK .NET si programas en .NET |
| Crear facturas desde una tienda online | POST /api/writeoperations |
| Volcar un informe a un panel o a otra base | POST /api/reports, o PG Sync si quieres SQL directo |
| Enterarte de una venta nueva sin preguntar | Webhook saliente en la sección de ventas |
| Que Dinaup lance un flujo de n8n cada hora | Petición HTTP programada |
| Refrescar pantallas con miles de cambios al día | Eventos Redis |
| Cuadros de mando en Power BI | PG Sync |
Empezar
La guía Conectar tu primera integración va de la clave API al primer flujo en marcha. Para probar los endpoints desde el navegador, la app Desarrollo de Play trae un playground: Webhooks Entrantes.