> ## Documentation Index > Fetch the complete documentation index at: https://muveya.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Solicitar uma exportação do resumo gerencial > Solicita uma exportação CSV assíncrona do resumo gerencial, sem dados sensíveis. Requer analytics:read. Retorna 202 com a tarefa em `pending` (ou já em `ready` quando a exportação é executada na hora); consulte GET /v1/analytics/exports/{exportId} para obter a URL de download assinada. O arquivo traz apenas contagens, quantidades e durações (sem custo, valor ou referência de paciente) e é auditável (tenant, ator, período, instante, checksum). ## OpenAPI ````yaml /openapi.pt.json post /v1/analytics/exports openapi: 3.1.0 info: description: >- A API pública para desenvolvedores da Muveya: recursos /v1 somente leitura, limitados a um tenant e autenticados com uma chave de API opaca. Um orçamento de solicitações por chave. title: API para desenvolvedores da Muveya version: 0.1.0 servers: - description: Produção url: https://api.muveya.com security: [] tags: - name: Chave de API - name: Clínicas - name: Depósitos - name: Catálogo - name: Inventário - name: Pedidos - name: Entregas - name: Análises paths: /v1/analytics/exports: post: tags: - Análises summary: Solicitar uma exportação do resumo gerencial description: >- Solicita uma exportação CSV assíncrona do resumo gerencial, sem dados sensíveis. Requer analytics:read. Retorna 202 com a tarefa em `pending` (ou já em `ready` quando a exportação é executada na hora); consulte GET /v1/analytics/exports/{exportId} para obter a URL de download assinada. O arquivo traz apenas contagens, quantidades e durações (sem custo, valor ou referência de paciente) e é auditável (tenant, ator, período, instante, checksum). operationId: requestAnalyticsExport parameters: - name: Accept-Language in: header required: false description: >- O idioma dos rótulos dos números do CSV: en, es ou pt (padrão en), definido quando a exportação é solicitada. As chaves de métrica, dimensões, unidades, valores e ids de evidência nunca mudam com ele. schema: type: string requestBody: required: false content: application/json: schema: type: object additionalProperties: false properties: period: type: string enum: - daily - weekly description: >- A frequência do resumo gerencial a exportar; o padrão é daily. responses: '202': description: A tarefa de exportação foi aceita. content: application/json: schema: $ref: '#/components/schemas/AnalyticsExport' headers: X-RateLimit-Limit: description: O orçamento de solicitações por chave na janela atual. schema: type: integer minimum: 1 X-RateLimit-Remaining: description: Solicitações restantes na janela atual (0 quando esgotadas). schema: type: integer minimum: 0 X-RateLimit-Reset: description: Segundos até a janela atual ser reiniciada. schema: type: integer minimum: 1 RateLimit: description: >- Estado do orçamento de solicitações segundo o rascunho da IETF, por exemplo "limit=120, remaining=119, reset=60". schema: type: string RateLimit-Policy: description: >- Política segundo o rascunho da IETF, por exemplo "120;w=60" (limite;segundos da janela). schema: type: string '400': description: O período não é daily nem weekly. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' headers: X-RateLimit-Limit: description: O orçamento de solicitações por chave na janela atual. schema: type: integer minimum: 1 X-RateLimit-Remaining: description: Solicitações restantes na janela atual (0 quando esgotadas). schema: type: integer minimum: 0 X-RateLimit-Reset: description: Segundos até a janela atual ser reiniciada. schema: type: integer minimum: 1 RateLimit: description: >- Estado do orçamento de solicitações segundo o rascunho da IETF, por exemplo "limit=120, remaining=119, reset=60". schema: type: string RateLimit-Policy: description: >- Política segundo o rascunho da IETF, por exemplo "120;w=60" (limite;segundos da janela). schema: type: string '401': description: >- A chave de API está ausente, é inválida, foi revogada, expirou ou está vinculada a uma clínica odontológica suspensa. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: A chave de API não tem o escopo que esta rota exige. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '429': description: A chave de API excedeu seu limite de solicitações na janela atual. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' headers: Retry-After: description: >- Segundos (valor positivo) até que outra solicitação seja permitida. schema: type: integer minimum: 1 X-RateLimit-Limit: description: O orçamento de solicitações por chave na janela atual. schema: type: integer minimum: 1 X-RateLimit-Remaining: description: Solicitações restantes na janela atual (0 quando esgotadas). schema: type: integer minimum: 0 X-RateLimit-Reset: description: Segundos até a janela atual ser reiniciada. schema: type: integer minimum: 1 RateLimit: description: >- Estado do orçamento de solicitações segundo o rascunho da IETF, por exemplo "limit=120, remaining=119, reset=60". schema: type: string RateLimit-Policy: description: >- Política segundo o rascunho da IETF, por exemplo "120;w=60" (limite;segundos da janela). schema: type: string security: - apiKeyBearer: [] components: schemas: AnalyticsExport: type: object additionalProperties: false required: - exportId - status - reportType - period properties: exportId: type: string description: O identificador opaco para consultar a tarefa de exportação. status: type: string enum: - pending - building - ready - failed reportType: type: string enum: - briefing period: type: string enum: - daily - weekly byteSize: type: integer description: Tamanho do arquivo gerado em bytes; presente quando estiver pronto. checksum: type: string description: >- SHA-256 em hexadecimal do arquivo sem dados sensíveis, o checksum de FR-AUD-02; presente quando estiver pronto. error: type: string description: >- Um código de motivo legível por máquina e não sensível; presente apenas quando a tarefa falhou. downloadUrl: type: string description: >- Uma URL de download assinada de curta duração; presente apenas quando está pronta e gerada novamente a cada consulta. downloadExpiresAt: type: string format: date-time description: Quando a URL de download atual deixa de funcionar. ProblemDetails: type: object additionalProperties: false required: - type - title - status - detail - instance - code - requestId properties: type: type: string format: uri title: type: string status: type: integer minimum: 400 maximum: 599 detail: type: string instance: type: string code: type: string requestId: type: string securitySchemes: apiKeyBearer: type: http scheme: bearer bearerFormat: opaque description: >- Chave de API opaca mvy_test_ enviada como token Bearer. O servidor deriva dela exatamente uma clínica odontológica; o caminho nunca leva um seletor de clínica odontológica. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.