Crear un registro por API
Guía para crear datos en Dinaup usando el endpoint WriteOperations.
Requisitos previos
- Clave API con permisos de escritura en la sección destino
- El ID de la sección donde vas a escribir
- Los nombres de campo (formato
pr_XXXXXXXXX)
¿Dónde encuentro los nombres de campo?
- Play Dinaup > Desarrollo > Esquema: explorador visual de secciones y campos
- doc-flex.dinaup.com: referencia completa de todas las secciones
- SDK .NET (MyDinaup): nombres tipados y legibles
Crear un registro nuevo
curl -X POST "https://webhook.dinaup.com/api/writeoperations?sectionId=ID_SECCION&FieldPrimary=id&scripts=true" \
-H "Authorization: Bearer TU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"id": "",
"pr_campo1": "valor1",
"pr_campo2": "valor2"
}'
Clave: "id": "" (cadena vacía) indica que es un registro nuevo. Dinaup genera el ID automáticamente.
Editar un registro existente
curl -X POST "https://webhook.dinaup.com/api/writeoperations?sectionId=ID_SECCION&FieldPrimary=id&scripts=true" \
-H "Authorization: Bearer TU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"id": "uuid-del-registro-existente",
"pr_campo1": "nuevo-valor"
}'
Clave: "id": "uuid-existente" indica que es una edición. Solo se modifican los campos enviados.
aviso
Si envías un UUID que no existe, la API devuelve error. No se crea un registro nuevo con ID personalizado.
Eliminar un registro (soft delete)
curl -X POST "https://webhook.dinaup.com/api/writeoperations?sectionId=ID_SECCION&FieldPrimary=id&scripts=true" \
-H "Authorization: Bearer TU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"id": "uuid-del-registro",
"eliminado": "1"
}'
Clave: el campo eliminado con valor "1" marca el registro como eliminado (soft delete).
Resumen de operaciones
Valor de id | Operación |
|---|---|
"" (vacío) | Crear nuevo registro |
| UUID existente | Editar registro |
| UUID inexistente | Error |
+ eliminado: "1" | Eliminar (soft delete) |
Parámetro scripts
scripts=true: ejecuta los scripts de la sección (validaciones, cálculos automáticos, triggers)scripts=false: escribe directamente sin ejecutar lógica de negocio
Usa scripts=true para operaciones normales y scripts=false solo para migraciones masivas de datos donde la velocidad es prioritaria.