api.transglot.ai/v1โทเค็น bearer, หนึ่งโปรเจกต์เอกสารอ้างอิง

อัปโหลดไฟล์ รับทุกภาษากลับมา

REST API สำหรับแปลแอปของคุณ การ POST หนึ่งครั้งจะอัปโหลดไฟล์ต้นฉบับ การ GET หนึ่งครั้งจะนำ locale ที่เสร็จแล้วกลับมา และโทเค็น bearer คือทั้งหมดของการตรวจสอบสิทธิ์ อะไรก็ตามที่สื่อสารผ่าน HTTP สามารถใช้งานได้

เข้า: เรียกครั้งเดียว

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

คำต่อเดือนในแผน Starter, แผนแรกที่สามารถสร้างโทเค็นได้

เริ่มต้นฟรี ดูส่วนสำหรับนักพัฒนา

60 คำขอต่อนาทีต่อโทเค็น · ทุกสถานะ 429 จะมีส่วนหัว Retry-After · แยกโทเค็นสำหรับ CI และ production

คอนโซลคือไคลเอนต์ API

ผลัก แปล ตรวจสอบ และดึง, แต่ละขั้นตอนคือ REST endpoint

ทุกแถวในภาพด้านล่างมีเส้นทางรองรับ: การผลัก การตรวจสอบ ศัพท์เฉพาะ ชุดงาน และการดึง ซึ่งทั้งหมดเข้าถึงได้จากโค้ดของคุณโดยใช้โทเค็นโปรเจกต์ พื้นที่เล่น API ในคอนโซลจะรันแบบอ่านอย่างเดียวกับโปรเจกต์ของคุณโดยตรง เพื่อให้คุณเห็นผลลัพธ์จริงก่อน

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

คุณอัปโหลดไฟล์ต้นฉบับ
POST/v1/push
แผงการตรวจสอบเติมข้อมูล
POST/v1/qa/run
คุณล็อกศัพท์
POST/v1/glossary
มุมมองชุดงานทำการโพลเอง
GET/v1/batches/:id
คุณนำคำแปลกลับมา
GET/v1/pull

หนึ่งเส้นทางต่อแผง, 60 ครั้งต่อนาที, ความสามารถต่อโทเค็น · การส่งออกคำแปลของคุณก็เป็นจุดปลายทางเช่นกัน

มันก็แค่ HTTP

สี่สิ่งที่ทีมมักสร้างเป็นอันดับแรก

แต่ละอย่างคือจุดปลายทางเดียวและโทเค็นโปรเจกต์ · ไม่มีอะไรที่ต้องใช้เวลาทั้งบ่าย

เกตการรวม · ไฟล์เวิร์กโฟลว์เดียว

ทำให้ Pull Request เป็นสีแดงเมื่อการแปลล้มเหลว

Cron · ทุกคืน

แปลบันทึกการปล่อยเวอร์ชันข้ามคืน ทุกคืน

บอต · สมัครสมาชิกเดียว

โพสต์ลง Slack ทันทีที่ชุดงานเสร็จสิ้น

เอเจนต์ · MCP

มอบเครื่องมือทั้ง 17 ชิ้นที่คุณมี ให้เอเจนต์ AI

คำขอต่อนาที

ต่อโทเค็น ไม่ใช่ต่อบัญชี พร้อมส่วนหัว Retry-After ในทุกการตอบกลับ 429 ที่ระบุจำนวนวินาทีที่ต้องรอ

รูปแบบไฟล์

ส่งเข้าและดึงออกในรูปแบบที่คลังข้อมูลของคุณใช้อยู่แล้ว พหูพจน์และตัวยึดตำแหน่งจะยังคงอยู่ทั้งสองทาง ระบุชื่อด้วย format= ในการเรียกใช้ใดก็ได้

เหตุการณ์ Webhook

แคตตาล็อกทั้งหมด แต่ละรายการมีตัวอย่างเพย์โหลดในรูปแบบเดียวกับที่ส่งจริง GET /v1/webhooks/events

เครื่องมือ MCP

โทเค็นโปรเจกต์เดียวกัน แต่ส่งให้รันไทม์ของเอเจนต์แทนที่จะใช้ curl npx -y @transglot/mcp

คำถามที่พบบ่อย

สิ่งที่นักพัฒนามักถามก่อนเริ่มคำขอแรก

ฉันจะยืนยันตัวตนกับ Transglot API ได้อย่างไร?

ส่ง Bearer Token: Authorization: Bearer $TRANSGLOT_TOKEN โทเค็นนี้เป็นของหนึ่งโปรเจกต์ ดังนั้นจึงไม่มี project id ในเส้นทาง และไม่มีคีย์ระดับบัญชีที่อาจรั่วไหล คุณสามารถสร้างโทเค็นบนหน้าโปรเจกต์ และแต่ละโทเค็นมีความสามารถของตัวเอง: push, pull, manage, read, write

API ฟรีหรือไม่?

ไม่ฟรี Bearer Token เริ่มต้นที่แผน Starter ราคา $19 ต่อเดือน แผนฟรีครอบคลุมการใช้งานคอนโซล ซึ่งเพียงพอที่จะดูว่าผลิตภัณฑ์เหมาะกับคุณหรือไม่ แต่ไม่สามารถสร้างโทเค็นได้ CLI, GitHub Action, webhooks, MCP และแพ็กเกจการส่งข้อมูลทั้งหมดอยู่เบื้องหลังโทเค็นเดียวกัน จึงมาพร้อมกัน

ฉันจะอัปโหลดสตริงไปยัง Transglot ได้อย่างไร?

POST /v1/push พร้อมไฟล์และรูปแบบของมัน เช่น -F "file=@lang/en.json" -F "format=laravel_json" ระบบจะตอบกลับด้วยสถานะ 202 และจัดคิวเป็นชุดงาน เฉพาะแถวที่มีการเปลี่ยนแปลงจริงเท่านั้นที่จะได้รับการแปล ดังนั้นการอัปโหลดไฟล์ที่ไม่มีการเปลี่ยนแปลงจึงไม่มีค่าใช้จ่าย

ฉันจะดึงคำแปลออกมาได้อย่างไร?

GET /v1/pull ในรูปแบบใดรูปแบบหนึ่งจาก 20 รูปแบบ เมื่อใดก็ตามที่ต้องการ นี่คือจุดปลายทางที่ CLI ห่อหุ้มไว้ และเป็นตัวที่ API Playground ทำงานแบบสด ไม่จำเป็นต้องยื่นคำขอส่งออก และไม่มีช่วงเวลาใดที่ข้อมูลจะไม่ใช่ของคุณ

ขีดจำกัดการเรียกใช้ API คืออะไร?

60 คำขอต่อนาที นับตามโทเค็น ไม่ใช่ตามบัญชี หากเกินขีดจำกัด คุณจะได้รับสถานะ 429 พร้อมส่วนหัว Retry-After ที่ระบุจำนวนวินาทีที่ต้องรอ และจะไม่มีการคิดค่าใช้จ่ายหรือบันทึกข้อมูลบางส่วน ให้แยกโทเค็นสำหรับ CI และ Production เพื่อให้กระบวนการ build ที่มีการแจ้งเตือนบ่อยไม่ส่งผลต่อแอปของคุณ

API รองรับภาษาอะไรบ้าง?

ไม่มีรายการที่ตายตัว ตัวตรวจสอบยอมรับแท็ก BCP-47 ทุกแบบที่ ICU รู้จัก ซึ่งครอบคลุม 708 โลเคลในตารางที่ตรวจสอบ รวมถึงมีระบบสำรองเชิงโครงสร้างสำหรับแท็กที่ไม่อยู่ในรายการ เพียงเพิ่มโลเคลลงในโปรเจกต์ การ push ครั้งถัดไปจะรวมโลเคลนั้นโดยอัตโนมัติ

สามารถ push และ pull ไฟล์รูปแบบใดได้บ้าง?

ยี่สิบรูปแบบ: JSON (แบบเรียบและซ้อน), Laravel PHP และ JSON, Android XML, iOS .strings, .stringsdict และ .xcstrings, Flutter ARB, XLIFF 1.2 และ 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV และ Unreal PO เจ็ดรูปแบบรองรับพหูพจน์ และไฟล์ที่ส่งกลับจะมีโครงสร้างเดียวกับตอนส่งไป

Transglot มีเว็บฮุกหรือไม่?

มี มีเหตุการณ์เว็บฮุก 12 รายการ รวมถึง batch.completed, translation.reviewed, qa.completed และ source_drift.repaired การส่งข้อมูลทุกครั้งมีการลงนาม HMAC พร้อมส่วนหัว timestamp เพื่อให้คุณตรวจสอบความถูกต้องได้ และ GET /v1/webhooks/events จะแสดงแคตตาล็อกพร้อมตัวอย่าง payload สำหรับแต่ละรายการ

มีเซิร์ฟเวอร์ MCP สำหรับเอเจนต์ AI หรือไม่?

ใช่ npx -y @transglot/mcp เผยแพร่เครื่องมือ 17 รายการผ่านโทเค็นโปรเจ็กต์ของคุณ ทำให้ผู้ช่วยสามารถอ่านคำแปล เขียนคำแปล เพิ่มภาษา เริ่มการทำงาน ตรวจสอบแบทช์ หรือแก้ไขอภิธานศัพท์ได้ ใช้ API เดียวกันและสิทธิ์เดียวกัน แต่เข้าถึงผ่านรันไทม์ของเอเจนต์แทนที่จะใช้ curl

สามารถรันใน CI ได้หรือไม่?

ใช่ GitHub Action (transglot/transglot-action@v1) และ CLI ต่างก็ห่อหุ้มจุดปลายทางเหล่านี้ เมื่อแถวถูกปฏิเสธ คำสั่ง transglot push --wait จะออกด้วยรหัส 4 และ Action จะทำให้จ็อบล้มเหลวในการรันนั้น หากต้องการหยุดการรวม ให้รันบน pull requests โดยตั้งค่าอินพุต commit เป็น none เพิ่มขั้นตอนที่ทำให้ล้มเหลวเมื่อไฟล์ที่ดึงมาขาดคีย์ และกำหนดให้จ็อบเป็นการตรวจสอบที่จำเป็นในการป้องกันสาขา

จะเกิดอะไรขึ้นเมื่อคำแปลไม่ผ่านการตรวจสอบคุณภาพ?

เกตแบบกำหนดได้สี่ตัวจะอ่านทุกแถว: ตัวแทนตำแหน่ง พหูพจน์ คำในอภิธานศัพท์ และความยาว หากพบตัวแทนตำแหน่งที่เสีย รูปแบบพหูพจน์ที่หายไป หรือคำในอภิธานศัพท์ที่ถูกห้าม ระบบจะพยายามแก้ไขอัตโนมัติหนึ่งครั้ง และหากยังล้มเหลว แถวนั้นจะถูกปฏิเสธแทนที่จะเขียนลงฐานข้อมูล แถวที่มีความยาวเกินขีดจำกัดเท่านั้นจะถูกเขียนลง ไม่ใช่ถูกปฏิเสธ GET /v1/batches/:id?include=failures แสดงรายการแถวที่ถูกปฏิเสธและเหตุผล

API จะทำให้การอินทิเกรตของฉันเสียหายหรือไม่?

ไม่ /v1 จะเพิ่ม endpoints และฟิลด์ตอบสนองเท่านั้น ฟิลด์ที่คุณ-parse อยู่แล้วจะไม่เปลี่ยนโครงสร้างหรือหายไป การเปลี่ยนแปลงที่ทำให้เสียหายจะถูกปล่อยภายใต้คำนำหน้าเวอร์ชันใหม่ ซึ่งปัจจุบันยังจองไว้และว่างอยู่ บันทึกการเปลี่ยนแปลง API จะบันทึกทุกการปล่อยเวอร์ชัน

ใช้งานร่วมกับสิ่งที่คุณใช้อยู่แล้ว