added
โมเดลคีย์การปรับใช้ ซึ่งโทเค็น bearer คือโปรเจกต์นั่นเอง นี่คือสิ่งที่ทั้ง CLI และ GitHub Action ทำงานร่วมกัน
api v1 · ปัจจุบัน
บันทึกการเปลี่ยนแปลง API
ไม่มีสิ่งใดถูกลบออก
/v1 มีการเพิ่มฟีเจอร์เท่านั้น จุดปลายใหม่และฟิลด์การตอบกลับใหม่จะถูกเพิ่มภายใต้คำนำหน้าเดิม และฟิลด์ที่คุณแยกวิเคราะห์อยู่แล้วจะไม่มีการเปลี่ยนแปลงโครงสร้างหรือหายไป การเปลี่ยนแปลงที่ทำให้ไม่เข้ากันกับเวอร์ชันก่อนหน้าจะเผยแพร่ภายใต้คำนำหน้าเวอร์ชันใหม่ ซึ่งปัจจุบันยังถูกจองไว้และว่างเปล่า
v1/api/v1
คำนำหน้าที่ใช้งานอยู่เพียงรายการเดียว
คำนำหน้าที่ใช้งานอยู่เพียงรายการเดียว
5 เวอร์ชันที่ปล่อยออกมา
11 การเปลี่ยนแปลง โดยไม่มีรายการใดที่ทำให้ไม่เข้ากันกับเวอร์ชันก่อนหน้า
รูปแบบของบันทึกการเปลี่ยนแปลง
หนึ่งคำนำหน้าเวอร์ชัน, ไม่มีการลบออก
สามในสี่ข้อนี้เป็นคุณสมบัติของบันทึกนี้เอง ส่วนข้อที่สี่คือขนาดของแคตตาล็อก webhook ที่ API ให้บริการ
5
การปล่อยเวอร์ชันบน /v1 ทุกครั้งเป็นการเพิ่มฟีเจอร์
1
คำนำหน้าเวอร์ชันที่ใช้งานอยู่ คำนำหน้าถัดไปถูกจองไว้และยังว่างเปล่า
0
การเปลี่ยนแปลงที่ทำให้ไม่เข้ากันกับเวอร์ชันก่อนหน้านับตั้งแต่ API เริ่มให้บริการ
12
เหตุการณ์ webhook ที่มีการลงนาม แหล่งที่มา: App\Enums\WebhookEvent
ระบุวันที่ตามการปล่อยเวอร์ชัน ไม่ใช่ตาม semver
ใช้ปุ่มลูกศรเพื่อเลื่อนดู
2026-07-08
การจัดส่งผ่าน CDN การใช้งาน และพื้นที่ทดสอบ
July 8, 2026 · 4 การเปลี่ยนแปลง
05 / 05
added
/v1/incontext/translations, /screenshots และ /suggest ขับเคลื่อนตัวแก้ไขภาพ โดยมี CORS จำกัดขอบเขตเฉพาะคำนำหน้านี้เท่านั้น
POST /v1/incontext/session แลกเปลี่ยนคีย์ที่เผยแพร่ได้และ Origin กับโทเค็นเซสชันที่มีขอบเขต
improved
การส่งออกแบบสองภาษาตอนนี้จะรายงานสิ่งที่ไม่สามารถแปลงกลับไปมาได้อย่างสมบูรณ์ แทนที่จะแทนที่ข้อความต้นทางอย่างเงียบๆ ฟิลด์ที่มีอยู่ไม่มีการเปลี่ยนแปลง ซึ่งเป็นจุดประสงค์หลักของการใส่ไว้ในส่วนหัว
GET /v1/pull ได้รับส่วนหัวการตอบสนอง X-Skipped-Keys และ X-Missing-Source-Keys
added
รวมถึง /v1/glossary/import, /export และ /extract เพื่อให้สามารถย้ายฐานคำศัพท์เข้าและออกได้โดยไม่ต้องเปิดคอนโซล
การจัดการฐานคำศัพท์แบบ CRUD เต็มรูปแบบผ่าน API: GET, POST, PUT และ DELETE บน /v1/glossary
added
ผลการตรวจสอบจะปรากฏในแถวคำแปลที่คุณดึงข้อมูลอยู่แล้ว จึงไม่จำเป็นต้องทำการโพลข้อมูลเพิ่มเติม
POST /v1/qa/run จะเริ่มกระบวนการตรวจสอบคุณภาพแบบอัตโนมัติและส่งคืนตัวระบุการรัน
added
สมัครรับข้อมูลตามจุดปลายทาง รายการทั้งหมดอยู่ใน App\Enums\WebhookEvent ซึ่งปัจจุบันมีสิบสองกรณี ให้นับจาก enum แทนบรรทัดนี้
เว็บฮุคที่มีการลงนามจะส่งเหตุการณ์เกี่ยวกับคีย์ คำแปล ภาษา พจนานุกรม และการตรวจสอบคุณภาพ ควบคู่ไปกับคู่แบทช์ต้นฉบับ
improved
การส่งข้อมูลจะรวมจำนวนและตัวอย่างสูงสุดยี่สิบรายการ แทนที่จะเรียกหนึ่งครั้งต่อแถวที่เปลี่ยนแปลง บันทึกการส่งข้อมูลจะบันทึกทุกความพยายามพร้อมเวลาของการลองใหม่ครั้งถัดไป
เหตุการณ์ที่มีความถี่สูง เช่น translation.updated จะถูกรวมเข้าด้วยกันเพื่อส่งเพียงครั้งเดียวในช่วงเวลาที่กำหนด เพื่อป้องกันไม่ให้การแก้ไขจำนวนมากท่วมจุดปลายทาง
added
ระบบจะส่งกลับ ETag และแคชอายุสั้น พร้อมรองรับ If-None-Match ด้วยสถานะ 304 ส่วนที่ไม่สามารถเปลี่ยนแปลงได้ภายใต้ /v{n} จะอ้างอิงตามเนื้อหาและถูกแคชไว้เป็นเวลาหนึ่งปี
GET /v1/cdn/{project}/{locale} แบบสาธารณะที่สามารถแคชที่ขอบเครือข่ายได้ จะให้บริการสตริงที่คุณเผยแพร่แล้ว
added
เรียกใช้ในระบบ CI ด้วย POST /v1/cdn/publish และอนุญาตการอ่านด้วยคีย์แบบอ่านอย่างเดียวเฉพาะในเฮดเดอร์ X-Transglot-Cdn-Key ปลอดภัยที่จะวางไว้หลัง CDN ของคุณเอง
การเผยแพร่จะยกระดับคำแปลปัจจุบันเป็นเวอร์ชันใหม่ที่ไม่สามารถเปลี่ยนแปลงได้ โดยสามารถทำได้ด้วยตนเองหรือทุกครั้งที่มีการพุช
added
ไม่มีการจัดเก็บเนื้อหาคำขอ เป็นเพียงการนับเท่านั้น
ทุกการเรียก /v1 ที่ผ่านการยืนยันตัวตนจะถูกนับตามโทเค็นต่อวัน และแสดงบนศูนย์กลางการปรับใช้
improved
โปรเจกต์ การดึงข้อมูล แบทช์ และการส่งออกพจนานุกรม ไม่มีการเปลี่ยนรูปแบบคำขอหรือการตอบกลับเพื่อให้ทำงานได้
ศูนย์กลางการปรับใช้เพิ่มพื้นที่ทดสอบ API ที่รันจุดปลายทางแบบอ่านอย่างเดียวแบบสดกับโปรเจกต์ของคุณ
ทะเบียนการเลิกใช้
ไม่มีสิ่งใด กำลังหายไป
หนึ่งแถวต่อพื้นผิวที่เผยแพร่ พร้อมกับการปล่อยเวอร์ชันที่จัดส่งมัน คอลัมน์สุดท้ายคือสิ่งที่ต้องจับตา: การลบจะปรากฏที่นั่นพร้อมวันที่ล่วงหน้าก่อนที่เหตุการณ์จะเกิดขึ้น
| พื้นผิว | เผยแพร่แล้ว | สถานะ | วันที่นำออก |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | ปัจจุบัน | ไม่มีกำหนดการ |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | ปัจจุบัน | ไม่มีกำหนดการ |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | ปัจจุบัน | ไม่มีกำหนดการ |
POST /v1/qa/run | June 12, 2026 | ปัจจุบัน | ไม่มีกำหนดการ |
Signed webhook events, twelve typed cases | June 30, 2026 | ปัจจุบัน | ไม่มีกำหนดการ |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | ปัจจุบัน | ไม่มีกำหนดการ |
แถวในตารางนี้จะไม่ถูกลบ หากพื้นผิวถูกยกเลิกการใช้งาน แถวนั้นจะยังคงอยู่และระบุวันที่ไว้ เพื่อให้คุณสามารถวางแผนล่วงหน้าได้ ซึ่งเป็นจุดประสงค์หลักของการเผยแพร่ข้อมูลนี้
คำมั่นสัญญาเรื่องความเข้ากันได้
สามกฎ ที่คุณสามารถสร้างต่อยอดได้
เพิ่มเติม
เอ็นด์พอยต์ใหม่และฟิลด์ตอบกลับใหม่จะถูกเผยแพร่ภายใน /v1 ฟิลด์ที่คุณแยกวิเคราะห์อยู่แล้วจะไม่เปลี่ยนโครงสร้างและไม่หายไป
คำนำหน้าใหม่
การเปลี่ยนแปลงที่ทำลายความเข้ากันได้จะถูกเผยแพร่ภายใต้คำนำหน้าเวอร์ชันใหม่ แทนที่จะอยู่ในเวอร์ชันนี้ คำนำหน้านั้นถูกสำรองไว้และยังไม่ได้ใช้งาน และการปล่อยรุ่นทุกครั้งหลังจากนั้นล้วนอยู่บน v1
เฮดเดอร์ที่โปร่งใส
เมื่อไม่สามารถส่งผ่านข้อมูลบางอย่างได้ครบถ้วน ระบบจะแจ้งไว้ในเฮดเดอร์ X-Skipped-Keys และ X-Missing-Source-Keys ถูกเพิ่มเข้ามาแทนที่จะเปลี่ยนแปลงเนื้อหาใต้มือคุณ
คำถามที่พบบ่อย
สิ่งที่นักพัฒนามักถามเกี่ยวกับการกำหนดเวอร์ชัน API และการเลิกใช้งาน
Transglot API มีการกำหนดเวอร์ชันหรือไม่?
ใช่ โดยใช้คำนำหน้า URL ทุกสิ่งที่เผยแพร่จนถึงปัจจุบันอยู่ภายใต้ /v1 ซึ่งเป็นคำนำหน้าเดียวที่ใช้ในปัจจุบัน ไม่มีส่วนหัวเวอร์ชัน ไม่มีการตรึงวันที่ และไม่มีการตั้งค่าใดๆ
การอัปเดตจะทำให้การผสานรวมของฉันเสียหายหรือไม่?
ไม่เกิดขึ้นภายใน /v1 มีการเพิ่มจุดปลายทางใหม่และฟิลด์การตอบสนองใหม่ แต่ฟิลด์ที่คุณแยกวิเคราะห์อยู่แล้วจะไม่เปลี่ยนโครงสร้างและไม่หายไป หากมีการเปลี่ยนแปลงที่ไม่สามารถทำแบบเพิ่มเติมได้ จะไปอยู่ภายใต้คำนำหน้าใหม่ และคำนำหน้าเก่ายังคงใช้งานได้
มีสิ่งใดถูกเลิกใช้งานหรือลบออกหรือไม่?
ไม่มี และทะเบียนข้างต้นระบุไว้เป็นรายแถว พื้นผิวที่เผยแพร่ทุกชิ้นจะแสดงพร้อมกับการเปิดตัวที่นำไปใช้ และคอลัมน์การลบที่ระบุว่า "ไม่มีแผน" ตลอดทั้งรายการ
หากจะมีการลบออก จะแจ้งล่วงหน้าอย่างไร?
การลบออกจะปรากฏในทะเบียนนั้นพร้อมวันที่ล่วงหน้าก่อนเกิดเหตุการณ์จริง และแถวนั้นจะยังคงอยู่ในตารางหลังจากนั้นแทนที่จะหายไป วันที่ที่สามารถวางแผนได้นั้นคือจุดประสงค์หลักของการเผยแพร่
ฉันจะรู้ได้อย่างไรเมื่อมีสิ่งใหม่ออกมา?
ทุกการเปิดตัวจะมีวันที่ระบุไว้ในหน้านี้ บันทึกการเปลี่ยนแปลงของผลิตภัณฑ์ครอบคลุมทุกอย่างอื่นที่เปิดตัว และคอนโซลจะแสดงเครื่องหมายเมื่อมีสิ่งที่คุณยังได้อ่าน
ทำไมจึงมีบันทึกการเปลี่ยนแปลงแยกต่างหากสำหรับ API?
เนื่องจาก API มีสัญญาความเข้ากันได้ซึ่งการเปิดตัวผลิตภัณฑ์ไม่มี นักพัฒนาที่ตรวจสอบว่าการผสานรวมยังทำงานอยู่ไม่ควรต้องเลื่อนผ่านงานฟีเจอร์เพื่อค้นหาข้อมูลดังกล่าว
ฉันจะเพิ่ม API ในแผนของฉันได้อย่างไร?
โทเค็น bearer เริ่มต้นที่แผน Starter ราคา $19 ต่อเดือน แผนฟรีครอบคลุมคอนโซลแต่ไม่สามารถสร้างโทเค็นได้ และ CLI, GitHub Action, webhooks และ MCP ทั้งหมดอยู่เบื้องหลังโทเค็นเดียวกันนั้น
เอกสารอ้างอิงของเอนด์พอยต์อยู่ที่ไหน?
อยู่ในหน้า API: การตรวจสอบสิทธิ์ เอนด์พอยต์ ขีดจำกัดอัตรา รูปแบบไฟล์ และแคตตาล็อกเว็บฮุก หน้านี้เป็นเพียงบันทึกการเปลี่ยนแปลงและช่วงเวลาเท่านั้น
ใช้งานร่วมกับสิ่งที่คุณใช้อยู่แล้ว
41 ตัวเชื่อมต่อ พร้อมใช้งานแล้ว
สัญญาคือผลิตภัณฑ์
สร้างบน API ที่ไม่เปลี่ยนแปลง
API มีให้ในแผน Starter ขึ้นไป แผนฟรีคิดค่าใช้จ่าย $0 พร้อมคำศัพท์เริ่มต้น 100,000 คำ (25,000 คำตอนสมัครสมาชิก, 75,000 คำหลังการตรวจสอบทางโทรศัพท์) และ 10,000 คำต่อเดือนหลังจากนั้น โดยไม่มี API หรือเว็บฮุก