Skip to main content

POST Criar Protocolo

Cria um protocolo médico. Protocolo da clínica (clinic: true) exige também a permissão manage_medical_protocols. Regras de conteúdo: o protocolo precisa de pelo menos um item ou um dos textos; o texto do atestado não pode conter código de CID (ele só entra com a concordância do paciente, caso a caso — CFM 2.381/2024).

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão create_medical_protocols.


Endpoint​

POST https://api-dev.imagemais.com.br/api/medical-protocols

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
namestring✅até 120 caracteres; não vazioNome do protocolo
clinicboolean✅true ou falsetrue: protocolo de toda a clínica; false: só de quem criou
cidsstring[]✅até 20 itens; formato A00 ou A00.0, e existir na CID-10Códigos da CID-10 do protocolo (pode ser vazio)
lifestyleAdvicestring❌até 5000 caracteresTexto de orientações de estilo de vida
medicalCertificatestring❌até 5000 caracteres; sem código de CIDTexto do atestado
declarationstring❌até 5000 caracteresTexto da declaração
medicalConductstring❌até 5000 caracteresTexto da conduta médica
itemsobject[]✅até 100 itensItens do protocolo
items[].typestring✅PRESCRIPTION, EXAM ou REFERRALTipo do item
items[].textstring✅até 1000 caracteres; não vazioTexto do item (ex.: nome do medicamento ou do exame)
items[].categorystring❌laboratorio ou imagensObrigatório quando type é EXAM
items[].procedureIdnumber❌inteiro positivoSó para EXAM: procedimento do catálogo da clínica. Sem ele, o exame é texto livre
items[].dataobject❌mapa de textoCampos da prescrição ou do encaminhamento (ex.: medicamento, dosagem, posologia). Ignorado em EXAM

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/medical-protocols' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Hipertensão — acompanhamento",
"clinic": true,
"cids": [
"I10"
],
"lifestyleAdvice": "Reduzir o sal e praticar atividade física.",
"medicalConduct": "Retorno em 30 dias.",
"items": [
{
"type": "PRESCRIPTION",
"text": "Losartana 50 mg",
"data": {
"medicamento": "Losartana",
"dosagem": "50 mg",
"posologia": "1 comprimido ao dia"
}
},
{
"type": "EXAM",
"text": "Creatinina",
"category": "laboratorio",
"procedureId": 42
}
]
}'

Respostas​

201 Sucesso​

{
"id": 31,
"name": "Hipertensão — acompanhamento",
"clinic": true,
"cids": [
{
"code": "I10",
"name": "Hipertensão essencial (primária)"
}
],
"lifestyleAdvice": "Reduzir o sal e praticar atividade física.",
"medicalCertificate": null,
"declaration": null,
"medicalConduct": "Retorno em 30 dias.",
"items": [
{
"type": "PRESCRIPTION",
"text": "Losartana 50 mg",
"category": null,
"data": {
"medicamento": "Losartana",
"dosagem": "50 mg",
"posologia": "1 comprimido ao dia"
},
"procedureId": null
},
{
"type": "EXAM",
"text": "Creatinina",
"category": "laboratorio",
"data": null,
"procedureId": 42
}
],
"updatedAt": "2026-11-10T14:00:00.000Z"
}

400 Requisição inválida​

Mensagens possíveis, além das de validação dos campos:

  • O protocolo precisa de pelo menos um item ou texto
  • O atestado do protocolo não pode ter CID: ele só entra com a concordância do paciente
  • CID não encontrado: {códigos}
  • Procedimento não encontrado no catálogo da clínica
  • Protocolo pessoal precisa de um usuário (chamada com API Key e clinic: false)
{
"message": "O protocolo precisa de pelo menos um item ou texto",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

Além de Permissões insuficientes, responde assim quando o protocolo é da clínica e falta manage_medical_protocols.

{
"message": "Permissões insuficientes para alterar os protocolos da clínica",
"error": "Forbidden",
"statusCode": 403
}