api.transglot.ai/v1mã bearer, một dự ántài liệu tham khảo

Tải lên một tệp. Nhận lại mọi ngôn ngữ.

API REST để dịch ứng dụng của bạn. Một lệnh POST tải lên tệp nguồn, một lệnh GET trả về bản địa hóa hoàn chỉnh và mã bearer là toàn bộ phần xác thực. Bất kỳ công cụ nào hỗ trợ HTTP đều có thể sử dụng nó.

trong: một cuộc gọi

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

300,000

từ mỗi tháng trên gói Starter, gói đầu tiên có thể tạo mã token.

Bắt đầu miễn phí Xem giao diện dành cho nhà phát triển

60 yêu cầu mỗi phút cho mỗi mã token · mỗi lỗi 429 đều kèm theo Retry-After · hãy dùng mã token riêng cho CI và môi trường production

bảng điều khiển là một ứng dụng khách API

Đẩy, dịch, kiểm soát và kéo, mỗi thao tác là một điểm cuối REST.

Mỗi hàng trong hình dưới đây đều có một tuyến đường phía sau: đẩy, kiểm soát, bảng thuật ngữ, lô xử lý và kéo, tất cả đều có thể truy cập từ mã của bạn bằng mã token dự án. Sân chơi API trong bảng điều khiển chạy các thao tác chỉ đọc trực tiếp với dự án của bạn, giúp bạn xem phản hồi thực tế trước.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Bạn tải lên tệp nguồn
POST/v1/push
Bảng kiểm soát được điền vào
POST/v1/qa/run
Bạn khóa một thuật ngữ
POST/v1/glossary
Chế độ xem lô tự động thăm dò
GET/v1/batches/:id
Bạn lấy lại bản dịch
GET/v1/pull

một route cho mỗi bảng, 60 lần mỗi phút, quyền hạn theo token · việc xuất bản dịch của bạn cũng là một endpoint

chỉ là http

Bốn điều mà các đội ngũ thường xây dựng đầu tiên.

mỗi cái là một endpoint duy nhất và một token dự án · không cái nào mất cả buổi chiều

cổng hợp nhất · một tệp quy trình làm việc

Chuyển pull request sang màu đỏ khi bản dịch gặp lỗi.

cron · hàng đêm

Dịch ghi chú phát hành qua đêm, mỗi đêm.

bot · một gói đăng ký

Đăng lên Slack ngay khi một lô hoàn tất.

agent · mcp

Cung cấp cho tác nhân AI cùng 17 công cụ mà bạn có.

yêu cầu mỗi phút

theo token, không phải theo tài khoản, với header Retry-After trên mọi phản hồi 429 cho biết số giây cần chờ.

định dạng tệp

đẩy và kéo định dạng mà kho lưu trữ của bạn đang sử dụng. Số nhiều và placeholder được giữ nguyên ở cả hai chiều. Chỉ định bằng format= trong bất kỳ lệnh gọi nào.

sự kiện webhook

toàn bộ danh mục, mỗi mục đều có ví dụ về payload với cấu trúc chính xác như khi giao nhận thực tế. GET /v1/webhooks/events.

công cụ mcp

cùng một token dự án, được cung cấp cho runtime của agent thay vì dùng curl. npx -y @transglot/mcp.

Câu hỏi thường gặp

Những điều nhà phát triển hỏi trước khi gửi yêu cầu đầu tiên.

Làm thế nào để xác thực với API Transglot?

Gửi bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. Token thuộc về một dự án, nên không có project id trong đường dẫn và không có khóa chung cho toàn tài khoản dễ bị rò rỉ. Bạn tạo token trên trang dự án và mỗi token mang các quyền hạn riêng: push, pull, manage, read, write.

API có miễn phí không?

Không. Bearer token 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, đủ để xem sản phẩm có phù hợp hay không, nhưng không thể tạo token. CLI, GitHub Action, webhook, MCP và gói phân phối đều nằm sau cùng một token đó, nên chúng đi kèm nhau.

Làm thế nào để tải chuỗi lên Transglot?

POST /v1/push kèm tệp và định dạng của nó, ví dụ: -F "file=@lang/en.json" -F "format=laravel_json". Phản hồi 202 và xếp hàng một lô. Chỉ những dòng thực sự thay đổi mới được dịch, nên việc đẩy một tệp không thay đổi sẽ không mất phí.

Làm thế nào để lấy lại bản dịch?

GET /v1/pull, với bất kỳ định dạng nào trong số 20 định dạng, vào bất kỳ lúc nào. Đây là endpoint mà CLI bao bọc và cũng là endpoint chạy trực tiếp trên sân chơi API. Không cần yêu cầu xuất tệp và không có khoảng thời gian nào dữ liệu ngừng thuộc về bạn.

Giới hạn tốc độ API là gì?

60 yêu cầu mỗi phút, được tính theo token thay vì theo tài khoản. Nếu vượt quá, bạn sẽ nhận mã lỗi 429 kèm tiêu đề Retry-After cho biết số giây cần chờ; không có khoản phí nào bị tính và dữ liệu không bị ghi một phần. Hãy sử dụng token riêng cho CI và môi trường production để bản build gây nhiễu không làm cạn kiệt tài nguyên ứng dụng của bạn.

API hỗ trợ những ngôn ngữ nào?

Không có danh sách cố định. Bộ xác thực chấp nhận mọi thẻ BCP-47 mà ICU nhận diện, tương ứng với 708 vùng miền trong bảng kiểm tra, cùng cơ chế dự phòng cấu trúc cho các thẻ nằm ngoài phạm vi đó. Thêm một vùng miền vào dự án và lần đẩy tiếp theo sẽ bao gồm nó.

Tôi có thể đẩy và kéo những định dạng tệp nào?

Hai mươi: JSON phẳng và lồng nhau, Laravel PHP và JSON, Android XML, iOS .strings, .stringsdict và .xcstrings, Flutter ARB, XLIFF 1.2 và 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV và Unreal PO. Bảy trong số đó hỗ trợ dạng số nhiều, và tệp trả về vẫn giữ nguyên cấu trúc ban đầu.

Transglot có hỗ trợ webhook không?

Có. Có 12 sự kiện webhook, bao gồm batch.completed, translation.reviewed, qa.completed và source_drift.repaired. Mọi lượt phân phối đều được ký HMAC kèm tiêu đề timestamp để bạn có thể xác minh, và GET /v1/webhooks/events trả về danh mục cùng mẫu payload cho từng sự kiện.

Có máy chủ MCP cho tác nhân AI không?

Có. npx -y @transglot/mcp cung cấp 17 công cụ thông qua mã thông báo dự án của bạn, vì vậy trợ lý có thể đọc bản dịch, viết bản dịch, thêm ngôn ngữ, bắt đầu lượt chạy, kiểm tra lô hoặc chỉnh sửa bảng chú giải thuật ngữ. Đây là cùng một API và cùng các quyền, được truy cập từ môi trường thời gian chạy của tác nhân thay vì từ curl.

Tôi có thể chạy nó trong CI không?

Có. GitHub Action (transglot/transglot-action@v1) và CLI đều bao bọc các điểm cuối này. Khi một hàng bị từ chối, transglot push --wait thoát với mã 4 và Action sẽ đánh dấu công việc đó là thất bại trong lượt chạy đó. Để ngăn chặn việc hợp nhất, hãy chạy nó trên các pull request với đầu vào commit được đặt thành none, thêm một bước sẽ thất bại khi tệp được kéo thiếu khóa và đặt công việc đó làm kiểm tra bắt buộc trong bảo vệ nhánh.

Chuyện gì xảy ra khi bản dịch không đạt kiểm tra chất lượng?

Bốn cổng xác định đọc mọi hàng: trình giữ chỗ, số nhiều, thuật ngữ bảng chú giải và độ dài. Một trình giữ chỗ bị lỗi, một dạng số nhiều bị thiếu hoặc một thuật ngữ bảng chú giải bị cấm sẽ nhận được một lần thử lại tự động để sửa chữa, và nếu vẫn thất bại thì hàng đó sẽ bị từ chối thay vì được ghi. Một hàng chỉ vượt quá độ dài cho phép sẽ được ghi, không bị từ chối. GET /v1/batches/:id?include=failures liệt kê các hàng bị từ chối và lý do.

API có bao giờ làm hỏng tích hợp của tôi không?

Không. /v1 chỉ bổ sung điểm cuối và trường phản hồi; một trường bạn đã phân tích sẽ không thay đổi cấu trúc hoặc biến mất. Thay đổi phá vỡ tương thích sẽ được phát hành dưới tiền tố phiên bản mới, hiện đang được bảo lưu và còn trống. Nhật ký thay đổi API ghi lại mọi bản phát hành.

hoạt động với những gì bạn đang chạy