POST Criar Máscara de Laudo
Cria uma máscara de relatório.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Sem permissão específica
Não exige @CheckPermissions — basta estar autenticado.
Endpoint
POST https://api-dev.imagemais.com.br/api/report-masks
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
name | string | ✅ | não vazio; até 200 caracteres | Nome da máscara de laudo |
description | string | ❌ | até 500 caracteres | Descrição detalhada da máscara |
content | string | ✅ | não vazio; mín. 10 caracteres; até 10000 caracteres | Conteúdo HTML da máscara com placeholders |
examType | string | ✅ | não vazio; até 100 caracteres | Tipo de exame associado à máscara |
isActive | boolean | ❌ | — | Status ativo/inativo da máscara |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/report-masks' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Hemograma Completo",
"description": "Template para hemograma completo com todos os parâmetros",
"content": "<div class=\"header\"><h2>{{NOME_PACIENTE}} - {{IDADE_PACIENTE}}</h2></div>",
"examType": "Hemograma",
"isActive": true
}'
Respostas
201 Sucesso
{
"id": 2,
"name": "TESTE DOC",
"description": "Máscara criada pela documentação",
"content": "<p>Laudo de exemplo da documentação.</p>",
"examType": "ULTRASSOM",
"isActive": false,
"createdAt": "2026-09-30T18:48:29.202Z",
"updatedAt": "2026-09-30T18:48:29.202Z"
}
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"name must be shorter than or equal to 200 characters",
"name should not be empty",
"name must be a string",
"content must be shorter than or equal to 10000 characters",
"content must be longer than or equal to 10 characters",
"content should not be empty",
"content must be a string",
"examType must be shorter than or equal to 100 characters",
"examType should not be empty",
"examType must be a string"
],
"error": "Bad Request",
"statusCode": 400
}