Skip to main content

POST Abrir Chamado

Abre um chamado de bug. Aceita até 5 anexos (PNG, JPG, GIF ou PDF, 10 MB cada) no campo "files".

Só com token de usuário

Envie o header Authorization: Bearer {accessToken} de um usuário. Esta rota não funciona com x-api-key: com x-api-key a resposta é 403 "Esta rota está disponível apenas para usuários autenticados.".

Permissão necessária

Exige a permissão create_bugs.


Endpoint​

POST https://api-dev.imagemais.com.br/api/bugs

Corpo da Requisição (multipart/form-data)​

CampoTipoObrigatórioDescrição
filesfile[]❌Arquivos anexados (zero ou mais)
titlestring✅Resumo curto do problema (mín. 5 caracteres; até 120 caracteres)
descriptionstring✅Detalhamento do erro e passos para reproduzir (mín. 10 caracteres; até 5000 caracteres)
severitystring❌Severidade (LOW, MEDIUM, HIGH)

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/bugs' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-F 'files=@anexo.pdf' \
-F 'title=Erro ao salvar prescrição na consulta' \
-F 'description=Ao clicar em Salvar a tela fica carregando e volta o erro...' \
-F 'severity=LOW'

Respostas​

201 Sucesso​

{
"uuid": "ede3346f-5aeb-4a93-8855-5367ea93d826",
"title": "TESTE DOC — chamado de exemplo",
"description": "Texto de exemplo.",
"severity": "LOW",
"status": "PENDING",
"adminComment": null,
"accountId": 1,
"userId": 1,
"resolvedBy": null,
"createdAt": "2026-09-30T18:48:42.123Z",
"updatedAt": "2026-09-30T18:48:42.123Z",
"files": [],
"user": {
"id": 1,
"name": "Nome Exemplo"
}
}

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": [
"title must be shorter than or equal to 120 characters",
"Escreva um título com pelo menos 5 caracteres.",
"title must be a string"
],
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

Mensagens possíveis:

  • Permissões insuficientes
  • Esta rota está disponível apenas para usuários autenticados.
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}