Referência Completa da API (OpenAPI 3.1.0)

Esta página disponibiliza a especificação OpenAPI 3.1.0 interativa da SusConecta Data API, cobrindo todas as 34 rotas operacionais, schemas de requisição e respostas padronizadas.

Especificação Canônica da API

A especificação OpenAPI oficial gerada diretamente pelo código-fonte do SusConecta está disponível em:

• Formato JSON (/openapi.json)
• Total de Rotas Homologadas: 34 caminhos
• Total de Operações: 34 operações RESTful

---

🧭 Resumo dos Grupos de Endpoints

Módulo	Prefixo / Rota	Descrição
Infraestrutura	GET /health, GET /ready	Liveness e readiness check de infraestrutura e bancos.
Território & Geometria	GET /v1/states, GET /v1/municipalities	Estados e municípios da malha canônica IBGE.
Catálogo Analítico	GET /v1/analytics/catalog	Catálogo com as 55 métricas homologadas e regras de aditividade.
Motor Analítico	POST /v1/analytics/query	Consultas analíticas rápidas, multi-estado, séries temporais e taxas.
Exportação de Relatórios	POST /v1/analytics/export	Exportação de dados estruturados com assinatura SHA-256 e fingerprint.
Estabelecimentos (CNES)	GET /v1/facilities, GET /v1/facilities/{cnes}	Cadastro Nacional de Estabelecimentos de Saúde.
Capacidade de Leitos	GET /v1/bed-capacity	Leitos existentes, SUS e não-SUS por tipo e categoria.
Equipamentos Médicos	GET /v1/equipment-inventory	Inventário de equipamentos em uso e existentes.
Serviços Especializados	GET /v1/specialized-services	Serviços e classificações cadastrados no CNES.
Produção Ambulatorial (SIA)	GET /v1/sia/monthly	Lotes mensais de procedimentos ambulatoriais aprovados.
Internações (SIH)	GET /v1/sih/monthly	Lotes mensais de internações hospitalares (AIH).
Financiamento em Saúde	GET /v1/health-financing/sources	Dados contábeis SIOPS, FNS e SICONFI.

---