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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | ✅ | Nome do médico (máx. 200 caracteres) |
procedureIds | number[] | ✅ | 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") |
scheduleDays | object[] | ✅ | Agenda por dia da semana — um item por dia atendido (mínimo 1) |
scheduleDays[].dayOfWeek | string (enum) | ✅ | DOM, SEG, TER, QUA, QUI, SEX ou SAB (um item por dia; não repetir) |
scheduleDays[].startTime | string | ✅ | Início do atendimento no dia (HH:mm) |
scheduleDays[].endTime | string | ✅ | Fim do atendimento no dia (HH:mm) |
scheduleDays[].intervalMinutes | number | ✅ | Duração de cada horário em minutos (inteiro >= 1) |
percentage | number | ❌ | Percentual do médico sobre os procedimentos |
userIds | number[] | ❌ | IDs dos usuários vinculados ao médico (usados, por exemplo, na fila do check-in) |
userId | number | ❌ | 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
}