> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dados.rio/llms.txt
> Use this file to discover all available pages before exploring further.

# Barramento de APIs

> Plataforma centralizada de integração e exposição de APIs da Prefeitura do Rio de Janeiro

O Barramento de APIs da Prefeitura do Rio é a plataforma centralizada para exposição e consumo de APIs entre os sistemas municipais, desenvolvida e mantida pela IplanRio. Garante segurança, monitoramento e governança para todas as integrações entre secretarias.

## Componentes

<CardGroup cols={3}>
  <Card title="Gateway" icon="network-wired" href="/barramento/gateway">
    Roteamento de tráfego via Istio + GKE com proteção Cloud Armor e certificados TLS gerenciados.
  </Card>

  <Card title="Autenticação" icon="key" href="/barramento/auth">
    Autenticação JWT via Identidade Carioca, OAuth2 com escopos por secretaria e controle de acesso.
  </Card>

  <Card title="MCP" icon="robot" href="/barramento/mcp">
    Model Context Protocol para conectar sistemas municipais a modelos de linguagem de forma padronizada.
  </Card>
</CardGroup>

## Casos de Uso

### Integração entre Secretarias

O barramento permite que secretarias consumam dados umas das outras de forma segura e rastreável:

* **SMS → SME**: Dados de saúde escolar via API autenticada por secretaria
* **SMTR → Todas**: APIs de mobilidade em tempo real para aplicativos cidadãos
* **SMF → Todas**: APIs financeiras para consolidação orçamentária

### Serviços ao Cidadão

APIs públicas expostas pelo barramento para aplicativos e portais:

* **Busca Unificada**: Consulta centralizada em múltiplas coleções municipais
* **RMI**: Registro Municipal Integrado com dados de pessoas físicas
* **Catálogo**: Discovery e recomendação de serviços municipais

## APIs Disponíveis

Para a referência completa de todas as APIs expostas pelo barramento, acesse a aba [API Reference](/api-reference/overview).

| API                | Finalidade                                             |
| ------------------ | ------------------------------------------------------ |
| Busca              | Pesquisa centralizada em dados municipais              |
| Catálogo           | Discovery de serviços por perfil e grupo social        |
| RMI                | Registro Municipal Integrado (pessoa física, telefone) |
| GO                 | Gestão de cursos e vagas de emprego                    |
| eAi Agent          | Gerenciamento de agentes de IA municipais              |
| Heimdall           | Autenticação e autorização centralizada                |
| Encurtador de URLs | Encurtamento e rastreamento de URLs municipais         |
| Subpav OSA SMS     | Comunicações e SMS do sistema Subpav OSA               |
| Surkai             | Busca semântica avançada                               |
