Skip to main content

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étodoRotaPermissãoDescrição
GET/medical-protocolsread_medical_protocolsLista os protocolos visíveis
GET/medical-protocols/{id}read_medical_protocolsUm protocolo, com textos e itens
POST/medical-protocolscreate_medical_protocolsCria um protocolo
PATCH/medical-protocols/{id}update_medical_protocolsAtualiza um protocolo
DELETE/medical-protocols/{id}delete_medical_protocolsExclui 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ão manage_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.