added
Mô hình khóa triển khai, trong đó bearer token CHÍNH LÀ dự án. Đây là thứ mà cả CLI và GitHub Action đều chạy trên đó.
api v1 · hiện tại
Nhật ký thay đổi API.
Không có gì bị loại bỏ.
/v1 chỉ bổ sung thêm tính năng. Các điểm cuối mới và trường phản hồi mới được thêm vào cùng tiền tố, và một trường bạn đã phân tích cú pháp sẽ không bao giờ thay đổi cấu trúc hoặc biến mất. Một thay đổi phá vỡ tương thích sẽ được phát hành dưới một tiền tố phiên bản mới, vốn được dành riêng và hiện vẫn trống.
v1/api/v1
tiền tố duy nhất đang được sử dụng
tiền tố duy nhất đang được sử dụng
5 bản phát hành
11 thay đổi, không có thay đổi nào phá vỡ tương thích
cấu trúc của nhật ký
Một tiền tố phiên bản, không có xóa bỏ.
Ba trong số bốn yếu tố này là thuộc tính của chính nhật ký này. Yếu tố thứ tư là quy mô danh mục webhook mà API cung cấp.
5
bản phát hành trên /v1, tất cả đều mang tính bổ sung
1
tiền tố phiên bản đang được sử dụng. Tiền tố tiếp theo được dành riêng và hiện đang trống
0
thay đổi phá vỡ tương thích kể từ khi API ra mắt
12
sự kiện webhook đã ký. Nguồn: App\Enums\WebhookEvent
được đánh dấu theo ngày phát hành, không theo semver
sử dụng các phím mũi tên để di chuyển
2026-07-08
Phân phối qua CDN, đo lường mức sử dụng và sân chơi API
July 8, 2026 · 4 thay đổi
05 / 05
added
/v1/incontext/translations, /screenshots và /suggest điều khiển trình soạn thảo trực quan, với CORS được giới hạn ở tiền tố đó và không gì khác.
POST /v1/incontext/session trao đổi một khóa có thể công khai và Origin để lấy token phiên có phạm vi.
improved
Xuất song ngữ giờ đây báo cáo những gì nó không thể xoay vòng thay vì âm thầm thay thế văn bản nguồn. Các trường hiện có không thay đổi, đây chính là lý do đặt nó vào tiêu đề.
GET /v1/pull đã bổ sung các tiêu đề phản hồi X-Skipped-Keys và X-Missing-Source-Keys.
added
Cùng với /v1/glossary/import, /export và /extract, giúp cơ sở thuật ngữ có thể được nhập/xuất mà không cần mở bảng điều khiển.
CRUD đầy đủ cho cơ sở thuật ngữ qua API: GET, POST, PUT và DELETE trên /v1/glossary.
added
Kết quả kiểm tra sẽ xuất hiện trên các hàng bản dịch mà bạn đang kéo về, nên không cần phải thăm dò thêm dữ liệu mới.
POST /v1/qa/run kích hoạt quy trình kiểm tra chất lượng tự động và trả về mã định danh của lượt chạy.
added
Đăng ký theo từng điểm cuối. Danh sách sự kiện nằm trong App\Enums\WebhookEvent, hiện có mười hai trường hợp; hãy đếm số lượng trong enum thay vì dựa vào dòng này.
Webhook đã ký phát ra các sự kiện liên quan đến khóa, bản dịch, ngôn ngữ, bảng chú giải và QA cùng với cặp lô ban đầu.
improved
Lần gửi bao gồm số lượng và tối đa hai mươi mẫu thay vì một lệnh gọi cho mỗi hàng thay đổi. Nhật ký gửi ghi lại mọi lần thử cùng với thời điểm thử lại tiếp theo.
Các sự kiện tần suất cao như translation.updated được gộp thành một lần gửi trong mỗi khoảng thời gian, giúp tránh tình trạng quá tải điểm cuối khi chỉnh sửa hàng loạt.
added
Nó trả về ETag và bộ nhớ cache ngắn hạn, đồng thời tôn trọng If-None-Match với mã 304. Phiên bản bất biến dưới /v{n} được địa chỉ hóa theo nội dung và lưu cache trong một năm.
GET /v1/cdn/{project}/{locale} công khai, có thể lưu cache ở biên, phục vụ các chuỗi đã xuất bản của bạn.
added
Kích hoạt nó trong CI bằng POST /v1/cdn/publish và ủy quyền đọc bằng khóa chỉ đọc chuyên dụng trong tiêu đề X-Transglot-Cdn-Key. An toàn khi đặt sau CDN của riêng bạn.
Việc xuất bản thúc đẩy các bản dịch hiện tại lên một phiên bản bất biến mới, thực hiện thủ công hoặc sau mỗi lần đẩy.
added
Không lưu trữ nội dung yêu cầu. Chỉ là bộ đếm và không có gì khác.
Mọi lệnh gọi /v1 đã xác thực đều được tính theo token mỗi ngày và hiển thị trên trung tâm triển khai.
improved
Dự án, pull, lô và xuất bảng chú giải. Không thay đổi hình dạng yêu cầu hoặc phản hồi để hỗ trợ tính năng này.
Trung tâm triển khai đã bổ sung sân chơi API, chạy trực tiếp các điểm cuối chỉ đọc đối với dự án của bạn.
sổ đăng ký hủy bỏ
Không có gì bị loại bỏ.
Một hàng cho mỗi bề mặt đã xuất bản, kèm theo bản phát hành đã cung cấp nó. Cột cuối cùng là cột cần theo dõi: việc loại bỏ sẽ xuất hiện ở đó với ngày tháng từ rất lâu trước khi nó xảy ra.
| Bề mặt | Đã phát hành | Trạng thái | Ngày loại bỏ |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | hiện tại | chưa lên lịch |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | hiện tại | chưa lên lịch |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | hiện tại | chưa lên lịch |
POST /v1/qa/run | June 12, 2026 | hiện tại | chưa lên lịch |
Signed webhook events, twelve typed cases | June 30, 2026 | hiện tại | chưa lên lịch |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | hiện tại | chưa lên lịch |
Một hàng không bao giờ bị xóa khỏi bảng này. Nếu một bề mặt bị ngừng sử dụng, nó vẫn giữ nguyên hàng và có thêm ngày tháng, vì việc lên kế hoạch cho việc loại bỏ là mục đích chính của việc công bố.
cam kết tương thích
Ba quy tắc bạn có thể xây dựng dựa trên.
bổ sung
Các điểm cuối mới và các trường phản hồi mới được phát hành trong /v1. Một trường bạn đã phân tích sẽ không thay đổi cấu trúc và không biến mất.
tiền tố mới
Một thay đổi phá vỡ sẽ được phát hành dưới một tiền tố phiên bản mới thay vì bên trong phiên bản này. Tiền tố đó được dành riêng và chưa sử dụng, và mọi bản phát hành trở lên đều nằm ở v1.
tiêu đề trung thực
Khi một pull request không thể xử lý trọn vẹn điều gì đó, nó sẽ thông báo trong tiêu đề. X-Skipped-Keys và X-Missing-Source-Keys đã được thêm vào thay vì thay đổi nội dung bên dưới.
Câu hỏi thường gặp
Những điều nhà phát triển thường hỏi về phiên bản API và ngừng hỗ trợ.
API Transglot có được phân phiên bản không?
Có, theo tiền tố URL. Mọi nội dung đã xuất bản đều nằm dưới /v1, đây là tiền tố duy nhất đang được sử dụng. Không có tiêu đề phiên bản, không ghim ngày và không có gì cần cấu hình.
Bản cập nhật có bao giờ làm gián đoạn tích hợp của tôi không?
Không, trong phạm vi /v1. Các điểm cuối mới và trường phản hồi mới sẽ được thêm vào, nhưng một trường mà bạn đã phân tích cú pháp sẽ không thay đổi cấu trúc và không biến mất. Nếu một thay đổi không thể thực hiện theo cách bổ sung, nó sẽ nằm dưới một tiền tố mới và tiền tố cũ vẫn hoạt động.
Có nội dung nào bị ngừng hỗ trợ hoặc xóa bỏ không?
Không có, và sổ đăng ký ở trên đã thể hiện rõ điều đó từng dòng một. Mọi bề mặt đã xuất bản đều được liệt kê kèm với bản phát hành đã cung cấp nó và cột xóa bỏ hiện đang ghi "chưa lên lịch" xuyên suốt.
Việc xóa bỏ sẽ được thông báo trước bao lâu?
Một mục xóa bỏ sẽ xuất hiện trong sổ đăng ký đó với ngày cụ thể từ rất lâu trước khi sự kiện xảy ra, và dòng đó sẽ vẫn nằm trong bảng sau đó thay vì biến mất. Việc cung cấp một ngày để bạn có thể lập kế hoạch chính là mục đích của việc công bố.
Làm sao để biết khi nào có nội dung mới được phát hành?
Mỗi bản phát hành đều có ngày trên trang này. Nhật ký thay đổi sản phẩm bao gồm mọi thứ khác được phát hành và bảng điều khiển hiển thị dấu hiệu khi có nội dung bạn chưa đọc.
Tại sao lại có nhật ký thay đổi riêng cho API?
Bởi vì API mang theo cam kết tương thích mà một bản phát hành sản phẩm thì không. Nhà phát triển kiểm tra xem tích hợp còn hoạt động hay không sẽ không cần phải cuộn qua các tính năng mới để tìm thông tin.
Làm thế nào để thêm API vào gói của tôi?
Mã bearer bắt đầu từ gói Starter với giá $19 mỗi tháng. Gói Miễn phí bao gồm bảng điều khiển nhưng không thể tạo mã token, còn CLI, GitHub Action, webhook và MCP đều yêu cầu cùng mã token đó.
Tài liệu tham khảo cho các điểm cuối ở đâu?
Trên trang API: xác thực, các điểm cuối, giới hạn tốc độ, định dạng tệp và danh mục webhook. Trang này chỉ là bản ghi lại những gì đã thay đổi và thời điểm thay đổi.
hoạt động với những gì bạn đang chạy
41 đầu nối, đã được tích hợp sẵn.
hợp đồng chính là sản phẩm
Xây dựng trên nền tảng API điều không thay đổi.
API có trên gói Starter trở lên. Gói Miễn phí là $0 với 100.000 từ để bắt đầu (25.000 khi đăng ký, 75.000 sau khi xác minh số điện thoại), 10.000 mỗi tháng sau đó, và không bao gồm API hay webhook.