API REST
La API REST de Dinaup permite interactuar con tus datos de forma programatica desde cualquier lenguaje de programacion. Todos los endpoints se sirven desde https://webhook.dinaup.com.
Autenticacion
Todas las peticiones (excepto el ping) requieren una Clave API de usuario en el header HTTP:
Authorization: Bearer <clave-api>
Las claves se generan desde dinaup.com > Claves API. Cada clave hereda los permisos del usuario al que pertenece.
Endpoints disponibles
| Metodo | Endpoint | Descripcion |
|---|---|---|
GET | / | Ping: verifica que el servidor esta operativo |
GET | /api/whoami | Datos del usuario autenticado |
POST | /api/reports | Consulta informes configurados en Flex |
POST | /api/dynamicdocuments | Genera documentos dinamicos |
POST | /api/writeoperations | Crea, edita o elimina registros |
GET | /api/tools/aeat | Validacion NIF/CIF (AEAT) |
GET | /api/tools/vies | Validacion NIF intracomunitario (VIES) |
→ Referencia completa de endpoints
Limites de tasa
Cada endpoint tiene un limite de peticiones por tenant:
| Endpoint | Tokens | Reposicion |
|---|---|---|
| WriteOperations | 30 | 5 tokens / 10 seg |
| Reports | 30 | 5 tokens / 10 seg |
| DynamicDocuments | 30 | 5 tokens / 10 seg |
| Whoami | 60 | 10 tokens / 10 seg |
| Herramientas | 10 | 2 tokens / 10 seg |
Si excedes el limite, recibiras 429 Too Many Requests con header Retry-After: 10.
Playground
Prueba los endpoints directamente desde Dinaup sin herramientas externas: