added
מודל מפתח ה-deploy, שבו הטוקן נושא הזהות הוא הפרויקט עצמו. זהו הבסיס עליו פועלים גם ה-CLI וגם פעולת ה-GitHub.
api v1 · נוכחי
יומן השינויים של ה-API.
שום דבר לא הוסר.
/v1 רק מוסיף דברים. נקודות קצה חדשות ושדות תגובה חדשים מתווספים בתוך אותה קידומת, ושדה שכבר מנותח על ידכם לעולם לא משנה את צורתו או נעלם. שינוי שובר יפורסם תחת קידומת גרסה חדשה, השמורה וכרגע ריקה.
v1/api/v1
הקידומת היחידה בשימוש
הקידומת היחידה בשימוש
5 מהדורות
11 שינויים, אף אחד מהם לא שובר תאימות
צורת היומן
קידומת גרסה אחת, ללא הסרות.
שלושה מתוך ארבעה אלו הם מאפיינים של היומן עצמו. הרביעי הוא גודל קטלוג ה-webhooks שה-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, כך שניתן להעביר בסיס מונדים פנימה והחוצה ללא פתיחת הקונסולה.
ניהול מלא של בסיס המונחים דרך ה-API: GET, POST, PUT ו-DELETE על /v1/glossary.
added
הממצאים מגיעים לשורות התרגום שכבר נמשכות, כך שאין צורך לבצע polling חדש.
POST /v1/qa/run מפעיל מעבר איכות מבוסס סוכן ומחזיר את ידית ההרצה.
added
הרשמה לכל נקודת קצה. הרשימה עצמה נמצאת ב-App\Enums\WebhookEvent, שמכילה כיום שנים-עשר מקרים; ספרו את ה-enumeration ולא את השורה הזו.
Webhooks חתומים שולחים אירועי מפתח, תרגום, שפה, גלוסרי ובקרת איכות יחד עם זוג הבתים המקורי.
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 משלכם.
פרסום מקדם את התרגומים הנוכחיים לגרסה אימיוטבלית חדשה, ידנית או בכל push.
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.
כותרות כנות
כאשר פעולת pull אינה יכולה להחזיר נתון בצורה מלאה, היא מציינת זאת בכותרת. X-Skipped-Keys ו-X-Missing-Source-Keys נוספו במקום לשנות את גוף התגובה מתחת לידיים שלך.
שאלות נפוצות
מה שמפתחים שואלים על גרסאות API והפסקת תמיכה.
האם ה-API של Transglot מנוהל לפי גרסאות?
כן, באמצעות קידומת URL. כל מה שפורסם עד כה נמצא תחת /v1, שהיא הקידומת היחידה בשימוש. אין כותרת גרסה, אין הצמדה לתאריך ואין מה להגדיר.
האם עדכון אי‑פעם ישבור את האינטגרציה שלי?
לא בתוך /v1. מתווספים נקודות קצה חדשות ושדות תגובה חדשים, אך שדה שכבר מנותח לא משנה את המבנה שלו ולא נעלם. אם שינוי לא ניתן לבצע בצורה מצטברת, הוא יתווסף תחת קידומת חדשה, והישנה תמשיך לעבוד.
האם משהו הופסק או הוסר?
שום דבר, והרישום למעלה מציין זאת שורה אחר שורה. כל ממשק שפורסם מופיע עם הגרסה שהפיצה אותו ועמודת הסרה שקוראת כרגע "לא מתוכנן" לכל אורכה.
כמה התראה תינתן לפני הסרה?
הסרה תופיע ברישום הזה עם תאריך הרבה לפני שתתרחש, והשורה תישאר בטבלה גם אחרי כן במקום להיעלם. תאריך שאפשר לתכנן לפיו הוא כל מטרת הפרסום.
איך אני יודע כשמשהו חדש משוחרר?
כל שחרור מתוארך בדף זה. יומן השינויים של המוצר מכסה כל דבר אחר שמשוחרר, והקונסולה מציגה סימן כשיש משהו שלא קראתם.
למה יש יומן שינויים נפרד ל-API?
כי ה-API נושא הבטחת תאימות ששחרור מוצר לא נושא. מפתח שבודק האם אינטגרציה עדיין עובדת לא אמור לגלול מעבר לעבודת פיצ'רים כדי לגלות זאת.
איך אני מוסיף את ה-API לתוכנית שלי?
אסימון Bearer מתחיל בתוכנית Starter ב-$19 לחודש. החינם מכסה את הקונסולה אבל לא יכול ליצור אסימון, וה-CLI, פעולת GitHub, Webhooks ו-MCP כולם נמצאים מאחורי אותו אסימון.
איפה נמצאת ההפניה לנקודות הקצה עצמן?
בדף ה-API: אימות, נקודות הקצה, מגבלת הקצב, פורמטי הקבצים וקטלוג ה-Webhooks. דף זה הוא רק רישום של מה השתנה ומתי.
עובד עם מה שכבר מופעל אצלך
41 מחברים, כבר מובנים.
החוזה הוא המוצר
בנייה על גבי API שאינו משתנה.
ה־API זמין בתוכנית Starter ומעלה. החינם הוא $0 עם 100,000 מילים להתחלה (25,000 בהרשמה, 75,000 לאחר אימות טלפוני), 10,000 בחודש לאחר מכן, וללא גישה ל־API או ל־webhooks.