Skip to main content

POST Criar Doutor

Cria um novo médico com seus procedimentos e sua agenda semanal (scheduleDays) — cada dia da semana pode ter horário e intervalo próprios.

Autenticação necessária

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


Endpoint​

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

Body​

CampoTipoObrigatórioDescrição
namestring✅Nome do médico (máx. 200 caracteres)
procedureIdsnumber[]✅IDs dos procedimentos vinculados como números (ex: [1, 2, 3]) — obtidos em Listar Doutores, campo doctorProcedures[].procedureId. ⚠️ Não enviar como string ("1", "2")
scheduleDaysobject[]✅Agenda por dia da semana — um item por dia atendido (mínimo 1)
scheduleDays[].dayOfWeekstring (enum)✅DOM, SEG, TER, QUA, QUI, SEX ou SAB (um item por dia; não repetir)
scheduleDays[].startTimestring✅Início do atendimento no dia (HH:mm)
scheduleDays[].endTimestring✅Fim do atendimento no dia (HH:mm)
scheduleDays[].intervalMinutesnumber✅Duração de cada horário em minutos (inteiro >= 1)
percentagenumber❌Percentual do médico sobre os procedimentos
userIdsnumber[]❌IDs dos usuários vinculados ao médico (usados, por exemplo, na fila do check-in)
userIdnumber❌ID do usuário principal vinculado

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/doctors' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Roberto Teste",
"procedureIds": [1, 2, 3],
"scheduleDays": [
{ "dayOfWeek": "SEG", "startTime": "08:00", "endTime": "12:00", "intervalMinutes": 30 },
{ "dayOfWeek": "QUA", "startTime": "13:00", "endTime": "18:00", "intervalMinutes": 20 }
]
}'

Respostas​

201 Criado com sucesso​

{
"data": {
"id": 5,
"name": "Dr. João da Silva",
"isActive": true,
"accountId": 1,
"createdAt": "2026-09-29T22:33:46.062Z",
"updatedAt": "2026-09-29T22:33:46.062Z",
"deletedAt": null,
"isBusy": false,
"percentage": 0,
"userId": null,
"doctorProcedures": [
{
"doctorId": 5,
"procedureId": 24,
"createdAt": "2026-09-29T22:33:46.062Z",
"updatedAt": "2026-09-29T22:33:46.062Z",
"deletedAt": null,
"procedure": {
"id": 24,
"name": "ECOCARDIOGRAMA",
"synonyms": "ecocardiografia, ultrassonografia cardíaca, ultrassom do coração, ecografia cardíaca, exame de ecocardiograma, cardiografia por ultrassom, ecografia do coração, ecografia Doppler, ecocardiograma colorido, eco cardíaco.",
"price": "190",
"accountId": 1,
"createdAt": "2026-09-17T16:28:53.375Z",
"updatedAt": "2026-09-17T16:28:55.379Z",
"deletedAt": null,
"laudoLocal": false,
"typeId": 3,
"referralId": null
}
}
],
"scheduleDays": [
{
"id": 113,
"doctorId": 5,
"accountId": 1,
"dayOfWeek": "SEG",
"startTime": "08:00",
"endTime": "12:00",
"intervalMinutes": 30,
"isActive": true,
"createdAt": "2026-09-29T22:33:46.062Z",
"updatedAt": "2026-09-29T22:33:46.062Z",
"deletedAt": null
},
{
"id": 114,
"doctorId": 5,
"accountId": 1,
"dayOfWeek": "QUA",
"startTime": "13:00",
"endTime": "18:00",
"intervalMinutes": 20,
"isActive": true,
"createdAt": "2026-09-29T22:33:46.062Z",
"updatedAt": "2026-09-29T22:33:46.062Z",
"deletedAt": null
}
],
"users": [],
"user": null
}
}

400 Bad Request​

Retornado quando nenhum dos procedureIds existe na conta. IDs inexistentes misturados a IDs válidos são ignorados silenciosamente.

{
"message": "Procedimentos não encontrados",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando scheduleDays está vazio ou um item é inválido.

{
"message": [
"Ao menos um dia de atendimento deve ser informado"
],
"error": "Bad Request",
"statusCode": 400
}

500 Erro Interno​

Retornado em falhas ao gravar — por exemplo, dayOfWeek repetido na mesma requisição (a agenda é única por médico e dia).

{
"message": "Erro ao criar médico",
"error": "Internal Server Error",
"statusCode": 500
}