POST Criar Requisição de Orçamento
Cria um pedido de orçamento.
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_budgets_requests.
Endpoint
POST https://api-dev.imagemais.com.br/api/budgets-requests/queue/create
Corpo da Requisição (multipart/form-data)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
images | file[] | ❌ | Arquivos anexados (zero ou mais) |
name | string | ✅ | Nome (não vazio) |
phone | string | ✅ | Telefone (não vazio) |
patientId | number | ❌ | Paciente já cadastrado escolhido na fila. Sem ele, um paciente novo é criado com o nome e o telefone informados. (inteiro; positivo) |
reason | string | ❌ | Motivo do orçamento, informado na fila. Pré-preenche o mesmo campo do orçamento quando a requisição é atendida — o operador pode ajustar antes de gerar. (até 500 caracteres) |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/budgets-requests/queue/create' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-F 'images=@anexo.pdf' \
-F 'name=Exemplo' \
-F 'phone=81999999999' \
-F 'patientId=42' \
-F 'reason=Encaminhado pelo Dr. Fulano para hemograma completo'
Respostas
201 Sucesso
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 should not be empty",
"name must be a string"
],
"error": "Bad Request",
"statusCode": 400
}
Também retornado com a mensagem:
{
"message": "Paciente não encontrado",
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}