Đá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.
Hiện vẫn chưa có spec OpenAPI/Swagger nào được công bố cho API, đó là lý do tài liệu tham chiếu này được viết tay từ các route handler thật thay vì được sinh tự động. Khi có một spec như vậy, phần này nên chuyển sang nội dung được sinh từ spec để nó không thể âm thầm lệch khỏi API thật.