Conectar tu primera integración

De la clave API a un flujo en marcha: copiar la URL y el token, comprobar la conexión con whoami, leer un informe, escribir un registro y recibir el primer aviso.

Al terminar, tu sistema lee y escribe en Dinaup por la API REST y recibe un webhook saliente cuando algo cambia. Los ejemplos van con curl; valen igual para cualquier lenguaje y para el módulo HTTP de Zapier, Make o n8n.

Antes de empezar

Un Administrador de la empresa para crear la clave API. Ver Claves API.
La app Desarrollo en la licencia y el interruptor Desarrollador en tu usuario. Ver Desarrollo.

Crea una clave API acotada

En Administración → Claves API, pulsa +. Ponle el nombre de la integración, elige el empleado que firma sus escrituras, acota las secciones que va a usar y marca Compatible WebHook. Los cambios en una clave tardan hasta 120 segundos en aplicarse.

Copia la URL y el token Bearer

En Desarrollo → Conectar → Webhooks Entrantes, la tarjeta Referencia de endpoints muestra el Endpoint Base, https://<clave-de-conexion>.dinaup.io/api. Elige la clave en Clave API y abre la pestaña Whoami: la vista previa curl lleva la cabecera Authorization: Bearer <token> completa.

Comprueba la conexión

curl "https://<clave-de-conexion>.dinaup.io/api/whoami" -H "Authorization: Bearer <token>"

Un 200 con { "user": "..." } confirma el token y el empleado. Un 401 en los primeros 120 segundos es normal; después, revisa Compatible WebHook y el empleado por defecto. Sin respuesta, prueba https://<clave-de-conexion>.dinaup.io/ping, sin token.

Lee un informe

Prepara el informe en FlexHub → Informes. Copia su identificador en Desarrollo → Esquema, pestaña Informes, columna ID, y ejecútalo:

curl -X POST "https://<clave-de-conexion>.dinaup.io/api/reports?id=<id-del-informe>&page=1&resultsPerPage=100&safeColumnsName=true&calculatePages=false" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"

Las filas llegan en data. Pide páginas hasta que llegue una con menos filas que resultsPerPage. Con safeColumnsName=true, renombrar un campo no rompe tu código.

Escribe un registro

Copia el identificador de la sección y los nombres pr_... de sus campos en Desarrollo → Esquema. Un id vacío crea el registro:

curl -X POST "https://<clave-de-conexion>.dinaup.io/api/writeoperations?sectionId=<id-de-la-seccion>&FieldPrimary=id&scripts=true" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{\"id\": \"\", \"pr_campo\": \"valor\"}"

Comprueba confirmed y aError en la respuesta. Para probar sin tocar datos reales, usa la Zona de pruebas, con campos de todos los tipos.

Recibe el primer aviso

En Desarrollo → Conectar → Webhooks Salientes, pulsa Nuevo: elige la sección, marca Disparar nuevos, pega la URL de tu servidor y rellena Bearer Token con un secreto que tu servidor compruebe. Envía un registro con el simulador de la misma pantalla y confirma que llega el POST con previousData y newData.

Las llamadas que fallan quedan en Errores API. El detalle de cada endpoint: Referencia de la API REST; el de los avisos: Webhooks salientes.