Visão Geral de Protocolos Médicos
Protocolos médicos são conjuntos prontos de condutas (prescrições, exames, encaminhamentos e textos de orientação, atestado, declaração e conduta) ligados a um ou mais diagnósticos (CID-10), que o médico aplica de uma vez na consulta.
Autenticação necessária
Todas as rotas exigem o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Isolamento por conta (multi-tenant)
Os protocolos são da conta do token. Protocolos excluídos (exclusão lógica) nunca são retornados.
Base
https://api-dev.imagemais.com.br/api/medical-protocols
Rotas e permissões
| Método | Rota | Permissão | Descrição |
|---|---|---|---|
GET | /medical-protocols | read_medical_protocols | Lista os protocolos visíveis |
GET | /medical-protocols/{id} | read_medical_protocols | Um protocolo, com textos e itens |
POST | /medical-protocols | create_medical_protocols | Cria um protocolo |
PATCH | /medical-protocols/{id} | update_medical_protocols | Atualiza um protocolo |
DELETE | /medical-protocols/{id} | delete_medical_protocols | Exclui um protocolo |
GET | /cid10 | — (só autenticado) | Busca na CID-10, para preencher cids |
Protocolo da clínica × pessoal
- Da clínica (
clinic: true): visível para todos da conta. Criar, editar ou excluir exige, além da permissão da ação, a permissãomanage_medical_protocols— também ao mudar um protocolo pessoal para clínica ou o contrário. - Pessoal (
clinic: false): só aparece para quem criou. Só pede a permissão da ação. Precisa de um usuário: com API Key não é possível criar um.