Recurso

Citas

10 operaciones · base https://api.bestdoctorsrd.com

GET/v1/appointments

Listar citas

Parámetros

NombreEnTipoObl.
doctorIdquerystring o nuloNo
patientIdquerystring o nuloNo
fromDatequerystring (date-time) o nuloNo
toDatequerystring (date-time) o nuloNo
statusquerystring o nuloNo
modequerystring o nuloNo
tenant_idquerystring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctalista de AppointmentOut
422Error de validaciónHTTPValidationError
POST/v1/appointments

Crear una cita

Parámetros

NombreEnTipoObl.
tenant_idquerystring o nuloNo

Cuerpo obligatorio AppointmentCreateIn

CampoTipoObl.
patientIdstring
doctorIdstring
departmentIdstring o nuloNo
scheduledAtstring (date-time)
reasonstring
modestringNo
branchIdstring o nuloNo
locationIdstring o nuloNo

Respuestas

CódigoDescripciónDevuelve
201Respuesta correctaAppointmentOut
422Error de validaciónHTTPValidationError
GET/v1/appointments/operations

Listar las operaciones de la cita

Parámetros

NombreEnTipoObl.
doctorIdquerystring o nuloNo
patientIdquerystring o nuloNo
fromDatequerystring (date-time) o nuloNo
toDatequerystring (date-time) o nuloNo
statusquerystring o nuloNo
modequerystring o nuloNo
searchquerystring o nuloNo
pagequeryintegerNo
pageSizequeryintegerNo
tenant_idquerystring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaAppointmentOperationsPageOut
422Error de validaciónHTTPValidationError
GET/v1/appointments/{appointment_id}

Consultar una cita

Parámetros

NombreEnTipoObl.
appointment_idpathstring
tenant_idquerystring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaAppointmentOut
422Error de validaciónHTTPValidationError
PATCH/v1/appointments/{appointment_id}

Modificar una cita

Parámetros

NombreEnTipoObl.
appointment_idpathstring
tenant_idquerystring o nuloNo

Cuerpo obligatorio AppointmentUpdateIn

CampoTipoObl.
patientIdstring o nuloNo
doctorIdstring o nuloNo
departmentIdstring o nuloNo
scheduledAtstring (date-time) o nuloNo
reasonstring o nuloNo
modestring o nuloNo
branchIdstring o nuloNo
statusstring o nuloNo
cancelReasonstring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaAppointmentOut
422Error de validaciónHTTPValidationError
POST/v1/appointments/{appointment_id}/action

Ejecutar una acción sobre la cita

Parámetros

NombreEnTipoObl.
appointment_idpathstring
tenant_idquerystring o nuloNo

Cuerpo obligatorio AppointmentOperationActionIn

CampoTipoObl.
actionstring
scheduledAtstring (date-time) o nuloNo
cancelReasonstring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaAppointmentOut
422Error de validaciónHTTPValidationError
GET/v1/appointments/{appointment_id}/closure-gates

Get Appointment Closure Gates

Qué le falta a esta consulta para poder cerrarse. Va declarada ANTES que `/v1/appointments/{appointment_id}`: al revés, «closure-gates» entraría por el parámetro de ruta y esto devolvería un 404 de cita inexistente. Existe para que la pantalla pueda decir qué falta en vez de dejar que el usuario se estrelle contra un 409 sin explicación. Es informativa: quien manda es el guardián del cierre, no esto.

Parámetros

NombreEnTipoObl.
appointment_idpathstring
tenant_idquerystring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaobjeto
422Error de validaciónHTTPValidationError
GET/v1/doctors/{doctor_id}/available-slots

Listar los horarios disponibles

Parámetros

NombreEnTipoObl.
doctor_idpathstring
datequerystring (date)
tenant_idquerystring o nuloNo
locationIdquerystring o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctalista de AvailableSlotOut
422Error de validaciónHTTPValidationError
POST/v1/public/appointments/requests

Crear una solicitud pública de cita

Creates a public appointment request tied to a provider and optionally to a specific slot.

Cuerpo obligatorio AppointmentRequestCreate

CampoTipoObl.
provider_idinteger
slot_idinteger o nuloNo
patient_namestring
patient_emailstring (email) o nuloNo
patient_phonestring o nuloNo
reasonstring

Respuestas

CódigoDescripciónDevuelve
201Respuesta correctaAppointmentRequestOut
422Error de validaciónHTTPValidationError
GET/v1/public/appointments/slots

Listar los horarios públicos disponibles

Returns unbooked appointment slots for public scheduling by provider.

Parámetros

NombreEnTipoObl.
provider_idProvider identifierqueryinteger
from_dateOptional lower bound for slot start timequerystring (date-time) o nuloNo

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctalista de AppointmentSlotOut
422Error de validaciónHTTPValidationError