Recurso

Sistema

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

GET/health

Health

Estado del servicio, y QUÉ CÓDIGO lo está sirviendo (#1112). Los dos campos nuevos existen porque el API corre en dos instancias que se despliegan por caminos distintos y una de ellas se quedaba con código viejo en memoria durante días. Comparar `codeRevision` entre `:8010` y `:8020` convierte ese desfase de «bug silencioso» en «una línea que no cuadra»; lo comprueba `scripts/deploy-api.sh` al final de cada despliegue. Sigue sin exigir autenticación —es lo que mira el balanceador— y no revela nada del código: `codeRevision` es un resumen criptográfico, no su contenido.

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaobjeto
GET/v1/platform/configuration

Configuración efectiva de la plataforma

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaPlatformConfigurationOut
PATCH/v1/platform/configuration/{key}

Sobrescribe un ajuste de plataforma

Parámetros

NombreEnTipoObl.
keypathstring

Cuerpo obligatorio SettingUpdateIn

CampoTipoObl.
valuestring
reasonstring

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaEditableSettingOut
422Error de validaciónHTTPValidationError
GET/v1/platform/configuration/{key}/history

Historial de cambios de un ajuste

De dónde viene el valor actual, leído de la bitácora. No hay tabla de historial y no es un olvido: cada escritura ya deja en `AuditLog` el actor, el momento, el motivo y los valores anterior y nuevo. Una segunda tabla con lo mismo se desincronizaría el día que alguien escriba por un camino nuevo, y partiría en dos la respuesta a «qué pasó con esto».

Parámetros

NombreEnTipoObl.
keypathstring

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctalista de SettingChangeOut
422Error de validaciónHTTPValidationError
POST/v1/platform/configuration/{key}/reset

Devuelve un ajuste a su valor del entorno

Parámetros

NombreEnTipoObl.
keypathstring

Cuerpo obligatorio SettingResetIn

CampoTipoObl.
reasonstring

Respuestas

CódigoDescripciónDevuelve
200Respuesta correctaEditableSettingOut
422Error de validaciónHTTPValidationError