Cambios y versiones
Cómo se versiona
La versión va en la dirección: https://api.odontosys.com/publica/v1.
- Dentro de la v1 sólo entran cambios compatibles: operaciones nuevas, campos nuevos en las respuestas, parámetros opcionales nuevos, códigos de error nuevos. Tu integración tiene que ignorar los campos que no conoce.
- Un cambio que rompa una integración sale en una versión nueva (
/v2), que convive con la v1 el tiempo necesario para que te adaptes, y se anuncia con anticipación. - La descripción OpenAPI (
/publica/v1/openapi.json) lleva el número de versión de la v1 eninfo.version.
Registro
1.2.0 — 16 de octubre de 2026
Los días que la clínica no atiende —los feriados de su país que respeta y sus cierres propios (vacaciones, un congreso)— salen en disponibilidad con trabaja: false y sin huecos, y el alta responde 422 agenda_no_trabaja, también si ese día tenía cargado otro horario. ultimoCambio no los refleja. La forma de las respuestas no cambia.
1.1.0 — 23 de septiembre de 2026
Confirmar una cita: PUT /citas/{id}/confirmacion, con el permiso nuevo citas:confirmar y el código de error 409 cita_no_confirmable. Ver Confirmar una cita. Las claves creadas antes no tienen el permiso: la clínica tiene que crear una nueva.
1.0.0 — 22 de septiembre de 2026
Primera versión, en piloto: ping, agendas, disponibilidad, búsqueda de pacientes, y consultar, crear y eliminar citas.