Documentación
Todo lo que necesitas para leer los datos de tu programa de gestión desde Power BI, Excel, tu CRM o un asistente de IA. ¿Prefieres que te lo dejemos montado? Escríbenos a hola@datavivo.es.
1. Empezar en 3 pasos
- Crea tu cuenta (14 días gratis, sin tarjeta).
- Instala el agente de Windows en el equipo donde están tus datos y elige qué tablas publicar. Solo lectura y sin abrir puertos.
- En el panel, crea una API key y copia el ejemplo listo para Power BI, Excel, tu CRM o la IA.
2. Autenticación
Cada petición lleva tu API key (empieza por dvk_) en la cabecera X-API-Key.
También se acepta Authorization: Bearer dvk_…. La clave se muestra una sola vez al crearla: guárdala como una contraseña y revócala desde el panel si se pierde.
3. Consultar datos
Sustituye tu-empresa por el identificador de tu cuenta (aparece en el panel).
# Tablas disponibles y sus columnas
curl -H "X-API-Key: dvk_..." https://datavivo.es/api/v1/tu-empresa
# Filas de una tabla (JSON)
curl -H "X-API-Key: dvk_..." "https://datavivo.es/api/v1/tu-empresa/clientes?limit=100"| Parámetro | Para qué |
|---|---|
limit | Filas por página (100 por defecto; el máximo depende del plan). |
offset | Filas que se saltan, para paginar: offset=0, offset=100… |
fields | Solo estas columnas, separadas por comas: fields=CODIGO,NOMBRE. |
format | json (por defecto) o csv para Excel. |
Las fechas llegan en formato ISO 8601 (2026-11-19) y los importes decimales como texto, para no perder céntimos.
4. Filtros
Añade COLUMNA=valor a la URL, o COLUMNA__operador=valor. Se combinan con «y» (hasta 20 por consulta).
| Operador | Significa | Ejemplo |
|---|---|---|
(ninguno) o eq | igual a | CIUDAD=Madrid |
ne | distinto de | ESTADO__ne=BAJA |
gt · gte | mayor que · mayor o igual | SALDO__gte=1000 |
lt · lte | menor que · menor o igual | FECHA__lt=2026-01-01 |
like | contiene (comodín %, sin distinguir mayúsculas) | NOMBRE__like=%25lopez%25 |
in | uno de la lista | CODIGO__in=1,2,3 |
En una URL, el % se escribe %25.
5. Power BI y Excel
En el panel, pestaña Power BI, elige una tabla y copia la consulta. En Power BI: Obtener datos → Consulta en blanco → Editor avanzado, pega y acepta. La consulta descarga todas las filas página a página y aplica a cada columna su tipo (número, fecha, texto). Para actualizar, basta con Actualizar.
En Excel sirve la misma consulta (Datos → Obtener datos → Desde otras fuentes → Consulta en blanco), o un CSV con ?format=csv.
Power BI y Excel son marcas de Microsoft. DataVivo es compatible con ellos, pero no está afiliado a Microsoft.
6. Asistentes de IA (MCP)
Con el plan Pro o superior, Claude, ChatGPT y otros asistentes compatibles con MCP pueden consultar tus tablas en lenguaje natural, siempre en solo lectura y solo sobre las tablas que autorizas.
URL: https://datavivo.es/mcp
Cabecera: Authorization: Bearer dvk_...
# Claude Code
claude mcp add --transport http tu-empresa https://datavivo.es/mcp --header "Authorization: Bearer dvk_..."El panel (pestaña IA (MCP)) te da la configuración exacta para Claude Desktop y otros clientes. Herramientas disponibles: list_resources y query_resource.
7. Límites por plan
| Plan | Peticiones/mes | Por minuto | Filas por petición | Tablas | IA (MCP) |
|---|---|---|---|---|---|
| Prueba gratuita | 2.000 | 120 | 500 | 3 | Sí |
| Starter | 10.000 | 120 | 1.000 | 5 | — |
| Pro | 100.000 | 300 | 5.000 | 25 | Sí |
| Business | 500.000 | 1200 | 10.000 | Ilimitadas | Sí |
8. Errores
Los errores se devuelven en JSON con un mensaje en español en el campo detail.
| Código | Qué pasa | Qué hacer |
|---|---|---|
| 400 | Parámetro o filtro no válido | Revisa el nombre de la columna y el operador |
| 401 | API key ausente, inválida o revocada | Crea una nueva en el panel |
| 402 | Prueba terminada o cuota mensual agotada | Elige o amplía tu plan en el panel |
| 403 | La clave no tiene acceso a esa tabla | Revisa los permisos de la clave |
| 404 | La tabla no existe o no está publicada | Consulta el catálogo: /api/v1/tu-empresa |
| 429 | Demasiadas peticiones por minuto | Espera unos segundos y reintenta |
| 503 · 504 | El agente local está apagado o no responde | Comprueba que el equipo y el servicio del agente están en marcha |
Prueba la API desde el navegador en la referencia interactiva (OpenAPI 3.1, descargable en /openapi.json). El código del agente es abierto: github.com/DataVivo/DataVivo-agent.