api.transglot.ai/v1אסימון bearer, פרויקט אחדהפניה

שליחת קובץ. קבלת כל השפות בחזרה.

REST API לתרגום האפליקציה שלכם. בקשת POST אחת מעלה את קובץ המקור, בקשת GET אחת מחזירה לוקאל גמור, ואסימון 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 ולסביבת הייצור

הקונסולה היא לקוח API

שליחה, תרגום, אימות ומשיכה, כל פעולה היא נקודת קצה REST.

לכל שורה בתמונה למטה יש מסלול (route) משלה: שליחה, שערים, מילון מונחים, אצוות ומשיכה — הכל נגיש מהקוד שלכם באמצעות אסימון הפרויקט. סביבת הבדיקה של ה-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
תצוגת האצבה מבצעת polling עצמאי
GET/v1/batches/:id
אתם מושכים את התרגומים חזרה
GET/v1/pull

מסלול אחד לכל פאנל, 60 לדקה, הרשאות לפי אסימון · גם הוצאת התרגומים היא נקודת קצה

זה פשוט HTTP

ארבעה דברים שצוותים בונים קודם כל.

כל אחד מהם הוא נקודת קצה יחידה ואסימון פרויקט · אף אחד מהם לא לוקח אחר הצהריים

שער מיזוג · קובץ זרימת עבודה אחד

הפוך את בקשת המשיכה לאדומה כשתרגום נכשל.

cron · לילי

תרגם את הערות השחרור במהלך הלילה, כל לילה.

בוט · מנוי אחד

פרסם ל-Slack ברגע שאצווה מסתיימת.

סוכן · mcp

הענקו לסוכן בינה מלאכותית את אותם 17 הכלים שיש לכם.

בקשות לדקה

לכל אסימון, לא לכל חשבון, עם כותרת Retry-After בכל תגובת 429 שמציינת כמה שניות להמתין.

פורמטי קבצים

דחוף ומשוך את הפורמט שהמאגר שלך כבר משתמש בו. רבים ומציין מיקום שורדים בשני הכיוונים. תן שם עם format= בכל קריאה.

אירועי webhook

הקטלוג המלא, כל אחד עם מטען דוגמה בצורה המדויקת של מסירה אמיתית. GET /v1/webhooks/events.

כלי mcp

אותו אסימון פרויקט, מועבר ל-runtime של סוכן במקום ל-curl. npx -y @transglot/mcp.

שאלות נפוצות

מה שמפתחים שואלים לפני הבקשה הראשונה.

איך אני מאמת מול ה-API של Transglot?

שלח אסימון bearer: Authorization: Bearer $TRANSGLOT_TOKEN. האסימון שייך לפרויקט אחד, כך שאין מזהה פרויקט בנתיב ואין מפתח ברמת החשבון שיכול להיחשף. אתה יוצר אסימונים בדף הפרויקט וכל אחד מהם נושא יכולות משלו: push, pull, manage, read, write.

האם ה-API חינם?

לא. אסימון bearer מתחיל בתוכנית Starter ב-$19 לחודש. החינם מכסה את הקונסולה, שזה מספיק כדי לראות אם המוצר מתאים, אבל אי אפשר ליצור אסימון. ה-CLI, פעולת GitHub, 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 ולסביבת הייצור אסימונים נפרדים ובנייה רועשת לא תרעיב את האפליקציה שלך.

אילו שפות נתמכות על ידי ה-API?

אין רשימה קבועה. המאמת מקבל כל תג BCP-47 ש-ICU מזהה, כלומר 708 לוקלים בטבלה שאליה הוא משווה, בתוספת נפילה מבנית לתגים מחוץ לטבלה. הוסיפו לוקל לפרויקט והדחיפה הבאה תכלול אותו.

אילו פורמטי קבצים ניתן לדחוף ולמשוך?

עשרים: 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 יש webhooks?

כן. קיימים 12 אירועי webhook, כולל batch.completed, translation.reviewed, qa.completed ו-source_drift.repaired. כל מסירה חתומה ב-HMAC עם כותרת חותמת זמן כדי לאפשר אימות, ו-GET /v1/webhooks/events מחזיר את הקטלוג עם מטען דוגמה לכל אחד מהם.

האם קיים שרת MCP לסוכני AI?

כן. הפקודה npx -y @transglot/mcp חושפת 17 כלים באמצעות אסימון הפרויקט שלכם, כך שמסייע יכול לקרוא תרגום, לכתוב אחד, להוסיף שפה, להתחיל הרצה, לבדוק אצווה או לערוך את הגלוסרי. זהו אותו API ואותן הרשאות, אך נגישים מסביבת ריצה של סוכן במקום מ־curl.

האם ניתן להריץ זאת ב-CI?

כן. פעולת GitHub (transglot/transglot-action@v1) וה־CLI עוטפים נקודות קצה אלה. כאשר שורה נדחתת, הפקודה transglot push --wait יוצאת עם קוד 4 והפעולה מכשילה את המשימה בהרצה זו. כדי לעצור מיזוג, הריצו אותו על בקשות משיכה (pull requests) כשהקלט commit מוגדר ל־none, הוסיפו שלב שנכשל כאשר קובץ שמשוך חסר מפתח, והגדירו את המשימה כבדיקה נדרשת בהגנת הענף.

מה קורה כאשר תרגום נכשל בבדיקת איכות?

ארבעה שערים דטרמיניסטיים בודקים כל שורה: מצייני מיקום, צורות ריבוי, מונחי גלוסרי ואורך. מציין מיקום פגום, צורת ריבוי חסרה או מונח גלוסרי אסור מקבלים ניסיון תיקון אוטומטי אחד; אם הם עדיין נכשלים, השורה נדחית ולא נכתבת. שורה שחרגה רק מאורכה המקסימלי נכתבת ולא נדחית. GET /v1/batches/:id?include=failures מציג את השורות שנדחו ואת הסיבה.

האם ה-API אי פעם ישבור את האינטגרציה שלי?

לא. /v1 רק מוסיף נקודות קצה ושדות תגובה; שדה שכבר מנותח על ידכם לא משנה את צורתו או נעלם. שינוי שובר יפורסם תחת קידומת גרסה חדשה, השמורה וכרגע ריקה. יומן השינויים של ה-API מתעד כל שחרור.

עובד עם מה שכבר מופעל אצלך