Versionado
La API está versionada bajo un prefijo /v1 — este es el estado actual.
Todo endpoint está bajo /v1
Toda ruta en esta referencia lleva el prefijo /v1 (/v1/chat, no /chat). La única excepción es /health, que
deliberadamente no lleva prefijo — es un chequeo de liveness de infraestructura, no parte del contrato público
versionado, y las herramientas de monitoreo apuntan a una ruta sin prefijo.
La API ahora publica una especificación OpenAPI legible por máquina — el JSON en bruto en /docs-json, y una
interfaz Swagger interactiva en /docs — generada directamente desde los route handlers y los tipos de
request/response reales, por lo que no puede desviarse silenciosamente como sí puede hacerlo un texto escrito a
mano. Esta página sigue siendo escrita a mano por ahora; migrarla para mostrar la especificación generada
directamente, en lugar de describirla a mano, es el siguiente paso natural, pero todavía no ha ocurrido.