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

# API Reference

> Contratos e endpoints do ecossistema NextMed, incluindo APIs REST (OpenAPI 3) e referências técnicas do PWA de atendimento.

Esta referência reúne as APIs do ecossistema **NextMed**: catálogo REST gerado a partir do OpenAPI 3 e documentação de contratos usados no **Webapp PWA** nos fluxos médicos. Use a sidebar para navegar por tag ou área.

## Referências técnicas do PWA Atendimento

Contratos e fluxos do **NextMed Webapp PWA** (sessão, encaminhamentos, vídeo, chat e integrações).

<CardGroup cols={2}>
  <Card title="API Interna" icon="route" href="/atendimento-tech/internal-api">
    Route handlers internos do Next.js, incluindo sessão, Dyte, chat e IA.
  </Card>

  <Card title="Autenticação" icon="key-round" href="/atendimento-tech/authentication">
    Login, persistência de sessão, refresh token, logout, cadastro e ativação.
  </Card>

  <Card title="Encaminhamentos" icon="send" href="/atendimento-tech/referrals">
    Contratos de solicitação, paciente, exames, relatório médico e notificações.
  </Card>

  <Card title="Chat e IA" icon="bot" href="/atendimento-tech/chat-ai">
    Endpoints de chat médico, sugestões, transcrição e anamnese com IA.
  </Card>

  <Card title="Videochamadas" icon="video" href="/atendimento-tech/video-calls">
    Integração Dyte, participantes, webhooks e atualização de presença médica.
  </Card>

  <Card title="Integrações Gateway" icon="network" href="/atendimento-tech/gateway-integrations">
    Convenções de headers, hosts e chamadas para serviços externos do gateway.
  </Card>
</CardGroup>

## APIs REST de gestão da plataforma

<CardGroup cols={2}>
  <Card title="User Controller" icon="users">
    Listar, criar e gerenciar usuários (admin, médico, validação de documentos).
  </Card>

  <Card title="Profile Controller" icon="user-check">
    Aprovar ou rejeitar perfis de usuário.
  </Card>

  <Card title="Institution Controller" icon="building-2">
    CRUD de instituições e vínculo de usuários.
  </Card>

  <Card title="Unity Controller" icon="map-pin">
    Unidades (locais) por instituição e seus usuários.
  </Card>

  <Card title="Specialty Controller" icon="stethoscope">
    Especialidades médicas.
  </Card>

  <Card title="Protocol Controller" icon="clipboard-list">
    Protocolos clínicos, formulários, perguntas, opções e faixas de pontuação.
  </Card>
</CardGroup>

<Info>
  No gateway, as rotas REST de gestão usam o prefixo `/admin-service`; o recurso de protocolos é exposto em `/protocols`.
</Info>

Os schemas de request e response estão em `components.schemas` do OpenAPI e são exibidos em cada página de endpoint. Você pode testar as chamadas no playground interativo disponível em cada endpoint.