Dinaup DocsAPI REST y webhooks
Las dos direcciones por HTTP: llamar a la API REST en la URL de tu empresa con un token Bearer, o recibir el POST de Dinaup cuando cambia un registro.
Dinaup se integra por HTTP en dos direcciones: tu sistema llama a la API REST de tu empresa, o Dinaup llama a tu sistema cuando cambia un registro.
| Dirección | Quién llama | Qué es | Página |
|---|---|---|---|
| API REST | Tú → Dinaup | Peticiones a https://<clave-de-conexion>.dinaup.io/api con la cabecera Authorization: Bearer <token> para leer informes, renderizar documentos, escribir registros y gestionar usuarios finales. | API REST: cómo funciona |
| Webhooks salientes | Dinaup → Tú | Un POST con previousData y newData a la URL que configuras, cuando se crea o modifica un registro de una sección. | Webhooks salientes |
API REST
La sirve el servidor de tu empresa en su propia URL, que Play muestra en Desarrollo → Inicio. El token sale de una clave API con Compatible WebHook marcado. Sin token, con mal formato o sin clave que lo respalde, la respuesta es 401 con la cabecera WWW-Authenticate: Bearer.
| Familia | Endpoints | Referencia |
|---|---|---|
| Datos | GET /api/whoami, POST /api/reports, POST /api/dynamicdocuments, POST /api/writeoperations | Referencia de la API REST |
| Usuarios finales | Cuentas, sesiones, inicio de sesión con código y clave-valor de tu propia aplicación | Usuarios finales |
| Estado | GET /ping y GET /version, sin token | Estado del servidor |
Cómo se compone el token, con qué permisos se ejecuta cada familia y qué límites tiene: API REST: cómo funciona.
Webhooks salientes
Se crean en Desarrollo → Conectar → Webhooks Salientes de Play (Webhooks Salientes). Eliges la sección, si disparan en altas o en modificaciones, y qué campos disparan o tienen que estar rellenos. Tu servidor responde 2xx en menos de 30 segundos; si no, Dinaup repite el aviso. Condiciones, cuerpo, cola y reintentos: Webhooks salientes.
Qué dirección uso
| Necesitas | Usa |
|---|---|
| Leer o escribir datos desde tu código | API REST |
| Crear ventas desde una tienda online | API REST: POST /api/writeoperations |
| Volcar un informe a un cuadro de mando | API REST: POST /api/reports |
| Enterarte de una venta nueva sin preguntar | Webhook saliente en la sección de ventas |
| Sincronizar clientes con un CRM | Webhook saliente para el aviso y API REST para el detalle |
| Crear un flujo sin programar | Webhook saliente hacia Zapier, Make o n8n |
Probar desde el navegador
La app Desarrollo de Play lanza cada endpoint, simula un webhook saliente sin herramientas externas y muestra el token de cada clave: Webhooks Entrantes y Webhooks Salientes.
Relacionado
- Programar peticiones HTTP: que Dinaup llame a una URL cada cierto tiempo.
- Eventos Redis: el mismo aviso que un webhook, en tu propio Redis.
- SDK .NET: el cliente .NET con clases tipadas, con su propia conexión.