{"openapi":"3.1.0","info":{"title":"DataVivo API","summary":"Los datos de tu programa de gestión (SQL Server, DBF, Excel), como API REST de solo lectura.","description":"**Guía de uso en español:** [/docs](/docs) · **Panel y API keys:** [/app](/app)\n\n1. Pulsa **Authorize** y pega tu API key (`dvk_...`).\n2. Abre una operación, pulsa **Try it out** y escribe el identificador de tu cuenta en `tenant_id`.\n\nFiltros en la URL: `CIUDAD=Madrid`, `SALDO__gte=100`, `CODIGO__in=1,2,3`, `NOMBRE__like=%25lopez%25`.","contact":{"name":"DataVivo","url":"https://datavivo.es/","email":"hola@datavivo.es"},"version":"0.2.0"},"paths":{"/mcp":{"post":{"tags":["mcp"],"summary":"Servidor MCP (JSON-RPC 2.0)","description":"Endpoint para asistentes de IA compatibles con MCP. Autenticación: `Authorization: Bearer dvk_...`. Herramientas: `list_resources` y `query_resource`. Configuración en [/docs#ia](/docs#ia).","operationId":"mcp_endpoint_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/{tenant_id}":{"get":{"tags":["datos"],"summary":"Tablas disponibles","description":"Lista las tablas que publica tu agente, con sus columnas y tipos, e indica si el agente está conectado.","operationId":"catalog_api_v1__tenant_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/{tenant_id}/{resource}":{"get":{"tags":["datos"],"summary":"Consultar una tabla","description":"Devuelve filas de una tabla. Añade filtros como parámetros: `COLUMNA=valor` o `COLUMNA__operador=valor` (eq, ne, gt, gte, lt, lte, like, in).","operationId":"query_resource_api_v1__tenant_id___resource__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$","title":"Tenant Id"}},{"name":"resource","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$","title":"Resource"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"description":"Filas por página","default":100,"title":"Limit"},"description":"Filas por página"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"description":"Filas que se saltan (paginación)","default":0,"title":"Offset"},"description":"Filas que se saltan (paginación)"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"description":"Columnas separadas por comas","title":"Fields"},"description":"Columnas separadas por comas"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","description":"json (defecto) o csv","default":"json","title":"Format"},"description":"json (defecto) o csv"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}},"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CatalogResponse":{"properties":{"tenant":{"type":"string","title":"Tenant"},"agent_online":{"type":"boolean","title":"Agent Online"},"agent_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Version"},"resources":{"items":{"$ref":"#/components/schemas/ResourceSchema"},"type":"array","title":"Resources"}},"type":"object","required":["tenant","agent_online","resources"],"title":"CatalogResponse"},"ColumnInfo":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"}},"type":"object","required":["name","type"],"title":"ColumnInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"QueryResponse":{"properties":{"resource":{"type":"string","title":"Resource"},"count":{"type":"integer","title":"Count"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"}},"type":"object","required":["resource","count","limit","offset","data"],"title":"QueryResponse"},"ResourceSchema":{"properties":{"name":{"type":"string","title":"Name"},"columns":{"items":{"$ref":"#/components/schemas/ColumnInfo"},"type":"array","title":"Columns"}},"type":"object","required":["name","columns"],"title":"ResourceSchema"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"API key del tenant (dvk_...)","in":"header","name":"X-API-Key"}}},"tags":[{"name":"datos","description":"Catálogo de tablas y consulta de filas (JSON o CSV)"},{"name":"mcp","description":"Servidor MCP (JSON-RPC 2.0) para asistentes de IA. Plan Pro o superior"}]}