Reference
Glossary
Bilingual Vietnamese and English glossary of the terms used in the O3O Office Online API documentation.
Terms used in the O3O Office Online API documentation, with the matching Vietnamese names.
| Term | Vietnamese | Meaning |
|---|---|---|
| Connection | Kết nối | One concurrent editing session: one open view with edit rights. One person with 3 documents open counts as 3 connections. |
| Editing session | Phiên soạn thảo | A view with a document open for editing on the editing server. |
| Read-only session | Phiên chỉ đọc | A view-only view; not counted as a connection. |
| Connection cap | Trần kết nối | Maximum concurrent connections of the edition: 50 in the community edition, the token's conns in the enterprise edition. |
| 5-minute sliding peak | Đỉnh trượt 5 phút | Highest connection count over the last 300 seconds (peak_5m); used for reporting and reconciliation. |
| Reconnect grace | Ân hạn nối lại | 120 seconds during which someone who just left a document can get back in even at the cap. |
| Fail-open | Fail-open | When the counter or the gate fails, the system lets users through instead of blocking them. |
| Gate (o3o-gate) | Gate (o3o-gate) | O3O's service that counts connections, checks the license and serves embedding. |
| Editing server (o3o-online) | Máy chủ soạn thảo (o3o-online) | The service that runs the in-browser co-editing editor. |
| DocBuilder | DocBuilder | Browserless document service: conversion, building, template filling, extraction (/v1/*). |
| o3oscript | o3oscript | Declarative JSON script for building text documents, spreadsheets and presentations through POST /v1/build. |
| Script unit | Đơn vị kịch bản | Size measure of an o3oscript, limited by the edition's max_script_units. |
| Job | Job | A DocBuilder task moving through queued, running, then done or failed. |
| Worker | Worker | A DocBuilder document process; each worker handles one job at a time. |
| Queue | Hàng đợi | Where jobs wait for a free worker; in memory in v1. |
| Synchronous and asynchronous | Đồng bộ và bất đồng bộ | Synchronous returns the file directly; asynchronous (async = true) returns a job to poll later. |
| WOPI | WOPI | Protocol that lets the editing server read and write files in a file store (CheckFileInfo, GetFile, PutFile). |
| WOPI host | WOPI host | The file store answering WOPI calls, for example Nextcloud, or the gate's internal WOPI host for embedding. |
| WOPISrc | WOPISrc | URL of one file on the WOPI host, created by the file store and called by the editing server. |
| Discovery | Discovery | /hosting/discovery: the catalogue giving the editor path for each file type. |
| API key | Khoá API | Secret string of 24 to 128 characters sent in Authorization: Bearer to call DocBuilder. |
| HS256 JWT | JWT HS256 | HMAC SHA-256 signed token used to call DocBuilder and to sign the embed config. |
| Session access_token | access_token phiên | Token of one embed session, generated by the gate; api.js uses it for you. |
| Callback | Callback | Request O3O sends to your server when a new version is saved or a job finishes. |
| HMAC signature | Chữ ký HMAC | The X-O3O-Signature header that lets the receiver prove a callback came from O3O. |
| Idempotent | Idempotent | Processing a message several times has the same effect as processing it once. |
| SSRF | SSRF | Attack that abuses a server to reach internal networks; O3O blocks it with URL checking rules. |
| License token | Token bản quyền | Ed25519-signed string that upgrades the system to the enterprise edition; verified offline. |
| Community edition | Bản cộng đồng | Free edition, 50 connections, limited API, no white label. |
| Enterprise edition | Bản doanh nghiệp | Edition priced per connection, with the full API and DocBuilder callbacks. |
| Annual subscription | Thuê bao năm | The year plan: valid until exp, plus 7 days of grace. |
| Perpetual | Vĩnh viễn | The life plan: never expires; update rights until upd. |
| Never-more-expensive rule | Quy tắc không bao giờ đắt hơn | The price charged for n connections is the cheapest of every size from n upwards. |
| White label | Nhãn trắng | Replacing logo, product name and colours with the customer's brand; coming soon. |
| DEV image | Image DEV | Upstream editing server image pinned by digest, for internal testing only. |
| Source build | Dựng từ nguồn | Building the O3O image from MPL 2.0 sources; experimental, not yet built. |
| MPL 2.0 | MPL 2.0 | Mozilla Public License 2.0, the file-level copyleft license of the editing server sources and of most of the LibreOffice in the DocBuilder image. |
| Reverse proxy | Reverse proxy | Server in front of O3O handling TLS and the domain, forwarding requests to o3o-proxy. |
| TLS termination | Kết thúc TLS | Decrypting https at the outer proxy; set O3O_ONLINE_SSL_TERMINATION=true. |
| WebSocket | WebSocket | Long-lived two-way connection between the browser and the editing server while editing. |
| frame-ancestors | frame-ancestors | Directive stating which pages may embed the editor in an iframe. |
| Instance | Instance | One O3O Office Online installation, identified by instance_id. |
| request_id | request_id | The req_ + 16 hex id of every request, in the X-O3O-Request-Id header and in errors. |
| Rate limit | Hạn mức tần suất | Counted DocBuilder requests allowed per minute and per day. |
| Retry-After | Retry-After | Header on 429 and 503 giving the seconds to wait. |
| Retention (TTL) | Thời gian giữ (TTL) | How long result files or saved versions stay downloadable before deletion. |