Bỏ qua, tới nội dung
Tài liệu APIv1

Bắt đầu

Các gói và khác biệt tính năng

Bản cộng đồng miễn phí 50 kết nối đồng thời; bản doanh nghiệp tính theo số kết nối, thuê bao năm hoặc vĩnh viễn kèm 3 năm cập nhật. Cách đếm kết nối, bảng giá, quy tắc không bao giờ đắt hơn và hạn mức DocBuilder của từng gói.

Trong trang này

Hai gói dùng chung một bản cài. Không có token bản quyền thì máy chủ chạy bản cộng đồng; nạp token doanh nghiệp hợp lệ thì trần kết nối và hạn mức DocBuilder nâng lên ngay, không cần khởi động lại.

So sánh hai gói#

Cộng đồngDoanh nghiệp
GiáMiễn phíTheo số kết nối, tối thiểu 50 mỗi đơn
Kết nối đồng thời50Đúng bằng trường conns của token bản quyền, kể cả khi nhỏ hơn 50
Token bản quyềnKhông cầnCần; xác minh ngoại tuyến bằng Ed25519
Nhãn trắng (logo, tên, màu)KhôngSắp có: chỉ có với image O3O dựng từ nguồn
Nhúng trình soạn thảo, callback lưu
Endpoint DocBuilder10 (không có POST /v1/template/render)11
Yêu cầu xử lý mỗi phút10clamp(60 * ceil(conns / 50), 60, 3000), tức 60 tới 3.000
Yêu cầu xử lý mỗi ngày200Không giới hạn
Job chạy song song1Bằng số worker đã cấu hình
Hàng đợi tối đa101.000
Cỡ tệp tối đa10 MB300 MB
Giữ tệp kết quả15 phút1.440 phút
Thời gian chờ đồng bộ60 s60 s
Thời gian tối đa của job120 s600 s
Callback của jobKhông
Đơn vị kịch bản tối đa50020.000
Tệp ra mỗi lần dựng15
Vượt trần tạm thờiKhôngSắp có

Một kết nối là gì#

Một kết nối là một phiên soạn thảo đồng thời: một cửa sổ trình soạn thảo đang mở ở chế độ sửa trên máy chủ. Một người mở 3 tài liệu ở chế độ sửa là 3 kết nối; ba người cùng sửa một tài liệu cũng là 3 kết nối.

Trường hợpTính kết nối
Phiên mở ở chế độ sửa
Phiên chỉ đọc (người dùng không có quyền ghi, hoặc mở với permission=readonly)Không
Mọi yêu cầu tới DocBuilder (/v1/*)Không
Kiểm tra sức khoẻ, /hosting/discovery, /hosting/capabilitiesKhông
Chuyển đổi tệp: dùng POST /v1/convert của DocBuilder; /cool/convert-to không mở qua o3o-proxy (trả 404)Không

Trần được áp trên số phiên sửa tức thời. o3o-gate báo thêm đỉnh trượt 5 phút (peak_5m) và ghi nhật ký đối soát mỗi 5 phút; dùng số này để quyết định mua thêm kết nối.

Bảng giá bản doanh nghiệp#

Số kết nốiThuê bao năm (mỗi kết nối mỗi năm)Vĩnh viễn, kèm 3 năm cập nhật (mỗi kết nối)
50 – 2005 USD10 USD
201 – 5004,5 USD9 USD
từ 5013,5 USD8 USD
  • Đơn giá áp cho toàn bộ số kết nối của đơn, không luỹ tiến theo bậc.
  • Tối thiểu 50 kết nối mỗi đơn.
  • Giá niêm yết bằng USD. Tỷ giá USD sang VNĐ được máy chủ bản quyền của o3o.vn chốt và lưu lúc TẠO đơn; mã QR giữ đúng số tiền đó. Đơn hết hạn thì tạo đơn mới theo tỷ giá mới.

Quy tắc không bao giờ đắt hơn#

Vì đơn giá giảm theo bậc, mua ít hơn một chút đôi khi lại đắt hơn mua nhiều hơn. Quy tắc chặn điều đó: số tiền thu cho n kết nối là giá rẻ nhất trong mọi mức m từ n trở lên (và không dưới 50), tính bằng m × đơn giá của m. Khi mức rẻ nhất là m lớn hơn n, bạn trả tiền của m và được cấp đủ m kết nối.

Hoá đơn ghi và token bản quyền cấp đúng số kết nối của mốc được tính. Ví dụ thuê bao năm: chọn 190 kết nối thì hoá đơn tính 201 kết nối × 4,5 USD = 904,5 USD, và token có conns = 201.

LoạiKhi muaTính như muaSố tiền
Thuê bao năm181 – 200201904,5 USD
Thuê bao năm390 – 5005011.753,5 USD
Vĩnh viễn181 – 2002011.809 USD
Vĩnh viễn446 – 5005014.008 USD

Ví dụ tính tiền#

Số kết nối cầnThuê bao nămVĩnh viễn
50250 USD500 USD
120600 USD1.200 USD
190904,5 USD (cấp 201 kết nối, thay vì 950 USD)1.809 USD (cấp 201 kết nối, thay vì 1.900 USD)
200904,5 USD (cấp 201 kết nối, thay vì 1.000 USD)1.809 USD (cấp 201 kết nối, thay vì 2.000 USD)
201904,5 USD1.809 USD
3001.350 USD2.700 USD
4501.753,5 USD (cấp 501 kết nối, thay vì 2.025 USD)4.008 USD (cấp 501 kết nối, thay vì 4.050 USD)
5001.753,5 USD (cấp 501 kết nối, thay vì 2.250 USD)4.008 USD (cấp 501 kết nối, thay vì 4.500 USD)
5011.753,5 USD4.008 USD
8002.800 USD6.400 USD

Token bản quyền trong v1#

  • o3o-gate và DocBuilder đọc token từ O3O_LICENSE_TOKEN, hoặc từ tệp O3O_LICENSE_FILE (mặc định /etc/o3o/license.token), đọc lại mỗi 60 giây.
  • Token được xác minh ngoại tuyến bằng chữ ký Ed25519; máy chủ không cần gọi ra Internet.
  • Thuê bao năm được thêm 7 ngày ân hạn sau ngày hết hạn; quá hạn thì máy chủ về bản cộng đồng, phiên đang mở không bị ảnh hưởng.
  • Token hỏng, sai sản phẩm hoặc thiếu: máy chủ vẫn chạy, ở bản cộng đồng, và /o3o/status giải thích lý do trong license.message.
  • DocBuilder chạy bản doanh nghiệp khi token hợp lệ và có tính năng api_full; callback của job cần thêm tính năng callback.
Sắp có

Kích hoạt, báo nhịp và thu hồi bản quyền trực tuyến qua office.o3o.vn; mua bản doanh nghiệp trực tuyến; vượt trần tạm thời cho bản doanh nghiệp; thống kê P95 30 ngày và trang biểu đồ sử dụng.

Khi chạm trần kết nối#

Tình huốngHành vi
Phiên đang mởKhông bị đụng tới.
Lưu tài liệuKhông bao giờ bị chặn.
Nối lại trong 120 giâyĐược cho vào dù đã chạm trần.
Phiên chỉ đọc mớiLuôn được cho vào, không tính.
Phiên sửa mới qua NextcloudTrang báo đạt giới hạn, có nút mở chỉ đọc và nút thử lại.
Phiên nhúng mới ở chế độ sửaMở ở chế độ chỉ đọc, sự kiện onLimitReached.