Conectar tu primera integración

Crea una clave API con permisos acotados

Toda integración se autentica con una clave API. La clave va vinculada a un usuario y hereda sus permisos: solo accede a lo que ese usuario puede ver y escribir.

La decisión que más importa para tu seguridad: crea un usuario específico para la integración y dale acceso únicamente a las secciones que el flujo necesita. Si la clave se filtra, el daño está acotado y puedes revocarla sin tocar a nadie más.

1. Entra al Panel de administración en dinaup.com.
2. Ve a Claves API y pulsa Crear clave API.
3. Asóciala al usuario de la integración (con permisos mínimos).
4. Copia la clave y guárdala en un gestor de secretos o en la configuración de tu servidor.

👉 Ver artículo: Claves API

Elige tu método

Con la clave en la mano, decide por dónde tiras según lo que quieras lograr:

• API REST — tu sistema le pregunta a Dinaup. Lee informes, genera documentos o escribe registros desde cualquier lenguaje. Base: https://webhook.dinaup.com.
• Webhooks salientes — Dinaup avisa a tu sistema. Configuras una sección y una URL, y recibes un aviso en cuanto algo cambia. Cero polling.
• Zapier / Make / n8n — sin código. Conectas Dinaup con miles de apps mediante webhooks, arrastrando bloques.

👉 Ver: referencia de la API REST · Webhooks · Zapier, Make y n8n

Prueba la conexión (ping y whoami)

Antes de montar nada, comprueba que la autenticación funciona con dos llamadas:

• Ping — confirma que el servidor responde. No necesita clave.
• Whoami — confirma que tu clave es válida y te dice con qué usuario operas.

# 1. El servidor está vivo (sin autenticación)
curl -X GET "https://webhook.dinaup.com"

# 2. Mi clave funciona y opero como el usuario correcto
curl -X GET "https://webhook.dinaup.com/api/whoami" \
  -H "Authorization: Bearer <tu-clave-api>"

Si whoami te devuelve los datos del usuario que esperabas, vas bien. Si recibes un 401, la clave es inválida o no la estás enviando en la cabecera.

👉 Ver: referencia completa de endpoints

Lee o escribe tus datos

Ya conectado, haz tu primera operación real con la API REST:

• Leer — configura un informe en Flex con las columnas y filtros que quieras y ejecútalo por API. Te devuelve las filas en JSON, paginadas.
• Escribir — usa WriteOperations. La misma llamada sirve para crear y para editar un registro; el borrado es lógico.

# Ejecutar un informe ya configurado en Flex
curl -X POST "https://webhook.dinaup.com/api/reports?id=<id-de-tu-informe>&page=1&resultsPerPage=100" \
  -H "Authorization: Bearer <tu-clave-api>" \
  -H "Content-Type: application/json" \
  -d '{}'

👉 Ver: referencia de la API REST

Monta tu primer flujo automático

Que Dinaup reaccione solo ante un evento. El caso típico —nueva venta → aviso a una herramienta externa— se monta con un webhook saliente.

1. En Dinaup Flex (o el módulo Desarrollo), crea un webhook saliente.
2. Elige la sección a vigilar (ej. Ventas/Ingresos) y marca Disparar en nuevos.
3. Pega la URL de destino: por ejemplo, la que te da un escenario de Make o n8n.
4. Añade un Bearer Token para que tu receptor verifique que el aviso viene de Dinaup.
5. Crea una venta de prueba en Dinaup y confirma que tu escenario la recibe.

A partir de ahí, el escenario de Make/n8n hace lo que quieras con el dato: mandarlo a Slack, a una hoja de cálculo, a tu CRM...

👉 Ver: configurar webhooks salientes · Zapier, Make y n8n