Đánh số phiên bản
API được đánh số phiên bản dưới prefix /v1 — đây là trạng thái hiện tại.
Mọi endpoint đều nằm dưới /v1
Mọi path trong tài liệu tham chiếu này đều có prefix /v1 (/v1/chat, không phải /chat). Ngoại lệ duy nhất là
/health, vốn cố ý không có prefix — đây là một liveness check hạ tầng, không thuộc hợp đồng công khai đã được
đánh số phiên bản, và các công cụ giám sát trỏ tới một path trần.
Một spec OpenAPI dễ đọc bằng máy giờ đã được chính API công bố — JSON thô tại /docs-json, và một Swagger UI
tương tác tại /docs — được sinh trực tiếp từ các route handler và kiểu request/response thật, nên nó không thể âm
thầm lệch như văn bản viết tay. Trang này hiện vẫn được viết tay; chuyển sang hiển thị trực tiếp spec được sinh ra,
thay vì mô tả nó bằng tay, là bước tiếp theo hợp lý nhưng chưa được thực hiện.