> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Obtener una fuente de datos por ID > Utiliza este endpoint para obtener la estructura del esquema de una fuente de datos específica, incluidas sus tablas y campos, para admitir la creación dinámica de filtros durante la generación de informes. ## OpenAPI ````yaml es/openapi/v3-current/reporter.yaml get /v1/data-sources/{dataSourceId} openapi: 3.1.0 info: contact: name: Discord community url: https://discord.gg/DnhqKwkGv3 description: >- Esta es la documentación OpenAPI de Reporter. El binario unificado de Reporter ejecuta la API REST (RUN_MODE=api), el worker de generación de informes de RabbitMQ (RUN_MODE=worker) o ambos; RUN_MODE=all ejecuta los dos en un único proceso para el desarrollo local. Todos los endpoints REST documentados aquí solo están disponibles cuando RUN_MODE=api o RUN_MODE=all (puerto :4005); el worker (puerto :4006) expone únicamente los endpoints de health y readyz. license: name: Lerian Studio General License title: Midaz Reporter API version: 4.0.0 servers: - url: http://localhost:4005 - url: https://localhost:4005 security: - BearerAuth: [] tags: - description: Instancias de informes generados y su ciclo de vida. name: Informes - description: Definiciones de informes reutilizables. name: Plantillas - description: Creación interactiva de plantillas de informes. name: Constructor de plantillas - description: Seguimiento de las fechas de vencimiento de informes programados. name: Plazos - description: Entradas configuradas que proporcionan datos a los informes. name: Fuentes de datos - description: Métricas agregadas de informes. name: Métricas - description: Catálogo publicado de eventos de negocio y políticas de entrega. name: Streaming paths: /v1/data-sources/{dataSourceId}: get: tags: - Fuentes de datos summary: Obtener una fuente de datos por ID description: >- Utiliza este endpoint para obtener la estructura del esquema de una fuente de datos específica, incluidas sus tablas y campos, para admitir la creación dinámica de filtros durante la generación de informes. operationId: getDataSource parameters: - description: Identificador único de la fuente de datos que deseas obtener. example: midaz_onboarding in: path name: dataSourceId required: true schema: description: Identificador único de la fuente de datos que deseas obtener. type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/DataSourceDetailsResponse' description: Correcto '400': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Solicitud incorrecta '401': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: No autorizado '403': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Prohibido '500': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error interno del servidor components: schemas: DataSourceDetailsResponse: properties: externalName: description: >- Nombre de la base de datos o del servicio expuesto por la fuente de datos. examples: - onboarding type: string id: description: Identificador estable usado en las solicitudes a la API de Reporter. examples: - midaz_onboarding type: string tables: description: Tablas o colecciones consultables expuestas por la fuente de datos. examples: - - fields: - id - name name: account items: $ref: '#/components/schemas/DataSourceTableResponse' type: - array - 'null' type: description: Tecnología de base de datos que respalda la fuente de datos. examples: - postgresql type: string type: object Detail: properties: code: description: >- Código de error de dominio estable y legible por máquina, limitado al servicio emisor (formato: -NNNN). examples: - ERR-0001 type: string detail: description: Explicación legible específica de esta instancia del problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalles individuales del error examples: - - location: body.templateId message: expected string to match 'uuid' format value: not-a-uuid items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: Referencia URI que identifica la instancia específica del problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de estado HTTP examples: - 400 format: int64 type: integer title: description: >- Resumen breve y legible del tipo de problema. Este valor no debe cambiar entre instancias del error. examples: - Bad Request type: string type: default: about:blank description: Referencia URI a la documentación legible del error. examples: - https://example.com/errors/example format: uri type: string type: object DataSourceTableResponse: properties: fields: description: Nombres de campos consultables en la tabla o colección. examples: - - id - name - parent_account_id items: type: string type: - array - 'null' name: description: Nombre de la tabla o colección. examples: - account type: string type: object ErrorDetail: properties: location: description: >- Lugar donde ocurrió el error, por ejemplo, 'body.items[3].tags' o 'path.thing-id' examples: - body.templateId type: string message: description: Texto del mensaje de error examples: - expected string to match 'uuid' format type: string value: description: Valor en la ubicación indicada examples: - not-a-uuid type: object securitySchemes: BearerAuth: bearerFormat: JWT description: >- Autenticación mediante token Bearer. Formato: 'Bearer {access_token}'. Solo es obligatoria cuando el plugin de autenticación está habilitado. scheme: bearer type: http ````