Nhật ký thay đổi

Nhật ký này ghi thay đổi của API công khai, mục mới nhất ở trên cùng. Mỗi mục ghi phiên bản dịch vụ, ngày, và loại thay đổi: Thêm, Sửa, Ngừng. Thay đổi phá vỡ chỉ xuất hiện khi có phiên bản API mới; xem Phiên bản và độ ổn định.

v1 — dịch vụ 1.0.0, hợp đồng chốt ngày 21/09/2026#

Thêm#

• DocBuilder, 11 endpoint: GET /v1/status, GET /v1/formats, GET /v1/limits, POST /v1/convert, POST /v1/build, POST /v1/template/render, POST /v1/extract/text, POST /v1/extract/meta, POST /v1/extract/thumbnail, GET /v1/jobs/{id}, GET /v1/files/{id}.
• Kịch bản o3oscript v1 cho văn bản, bảng tính và trình chiếu; điền mẫu {{truong}} và lặp hàng bảng.
• Gate: GET /o3o/status, GET /o3o/limits, GET /o3o/healthz; đếm kết nối, đỉnh trượt 5 phút, ân hạn nối lại 120 giây, trang chạm trần tiếng Việt, fail-open, nhật ký đối soát CSV.
• Lớp nhúng: api.js, O3O.Editor với 7 sự kiện và 5 phương thức, phiên nhúng, WOPI host nội bộ.
• Callback document.saved, document.closed, job.done, job.failed, ký HMAC SHA-256.
• Xác thực bằng khoá API và JWT HS256; định dạng lỗi thống nhất; header giới hạn tần suất.
• Token bản quyền Ed25519 xác minh ngoại tuyến; bản cộng đồng 50 kết nối và bản doanh nghiệp theo token, tối thiểu 50 kết nối mỗi đơn.
• Bản Docker: proxy, máy chủ soạn thảo (image DEV), gate, DocBuilder, hồ sơ nextcloud.
• Chống SSRF ở gate và DocBuilder cho mọi URL do bên ngoài cung cấp, kèm ghim IP chống DNS rebinding: tên miền được phân giải một lần, mọi địa chỉ được kiểm, rồi kết nối đi thẳng tới đúng địa chỉ đã kiểm (tải tệp, từng chặng chuyển hướng, callback). Mục theo tên trong O3O_FETCH_ALLOW_HOSTS được phân giải lúc nối; mục CIDR vẫn được ghim. Xem Bảo mật khi chạy thật.
• Proxy trong và khởi động an toàn: mọi nâng cấp WebSocket tới máy chủ soạn thảo phải qua gate, yêu cầu WebSocket mà gate không phân tích được bị từ chối; bảng quản trị và số liệu của máy chủ soạn thảo bị chặn ở proxy kể cả dạng có dấu / cuối; compose từ chối khởi động khi chưa đặt mật khẩu quản trị máy chủ soạn thảo, và gate ở chế độ chạy thật từ chối khởi động khi mật khẩu đó còn trống hoặc là CHANGE_ME. Xem Reverse proxy.

Chưa có trong bản này#