הוספת תרגום רקע לתור עבור כל המסמכים שפורסמו מסכמת רכיבים אחת או יותר לקבוצת שפות יעד. התוצאות מתווספות או מתעדכנות בטבלת translations עם השלמת כל תרגום.

נקודת קצה: POST /translation אימות: Bearer JWT (WorkOS)

גוף הבקשה

{
  "websiteId": "<uuid>",
  "schemaNames": ["post", "hero"],
  "languages": ["fr", "es", "de"]
}

* יש לספק schemaNames או schemaName.

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

תגובה

{
  "job_id": "<uuid>",
  "website_id": "<uuid>",
  "schema_name": null,
  "schema_names": ["post", "hero"],
  "languages": ["fr", "es", "de"],
  "status": "queued",
  "documents_processed": 12,
  "translations_scheduled": 30,
  "translations_skipped": 6,
  "translations_completed": 0,
  "translations_failed": 0,
  "reused": false,
  "created_at": "2026-07-15T18:00:00Z",
  "updated_at": "2026-07-15T18:00:00Z"
}

מחזירה:

• 202 Accepted כאשר התרגומים הוכנסו לתור
• 200 OK כאשר כל התרגומים כבר עדכניים
• את המשימה הפעילה הקיימת כאשר בקשה זהה כבר מתבצעת

סטטוסי המשימה האפשריים הם:

• preparing
• queued
• running
• completed
• completed_with_errors
• failed

דילוג על תרגומים עדכניים

כל צמד מסמך-שפה מאחסן גיבוב SHA-256 של התוכן שפורסם במסמך המקור.

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

אם התוכן שפורסם משתנה בזמן שמשימה מקבילה פעילה, השירות דוחה את הבקשה החדשה. יש לשלוח אותה שוב לאחר סיום המשימה הפעילה.

אופן העיבוד

התרגום מתבצע באופן אסינכרוני לאחר התגובה הראשונית.

• העבודה מעובדת במקביליות מוגבלת.
• כשלים זמניים מופעלים מחדש עם השהיה מדורגת.
• תוצאות מוצלחות נשמרות עם השלמתן.
• כשלים בודדים בהסקה או בשמירה מתועדים במשימה.
• משימה שהצליחה באופן חלקי מסתיימת ב-completed_with_errors.

דוגמה

curl -X POST '{TRANSLATION_API_URL}/translation' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{
    "websiteId": "<uuid>",
    "schemaNames": ["post", "hero"],
    "languages": ["fr", "es"]
  }'

שגיאות

• 400 Bad Request — סכמות או שפות חסרות, שפה אינה נתמכת, או שהאצווה חורגת מהמגבלה שהוגדרה
• 401 Unauthorized — אסימון bearer חסר או לא חוקי
• 409 Conflict — עבודה תואמת פעילה, אך תוכן המקור שפורסם השתנה
• 500 Internal Server Error — לא ניתן היה להכין את מסמכי המקור או שפעולת מסד נתונים נכשלה

קבלת משימת תרגום

אחזור ההתקדמות העדכנית ביותר של משימת תרגום.

נקודת קצה: GET /translation-jobs/{job_id} אימות: Bearer JWT (WorkOS)

תגובה

התגובה משתמשת באותו אובייקט משימה שהוחזר על ידי POST /translation, עם סטטוס ומוני התקדמות מעודכנים.

{
  "job_id": "<uuid>",
  "website_id": "<uuid>",
  "schema_name": null,
  "schema_names": ["post", "hero"],
  "languages": ["fr", "es"],
  "status": "running",
  "documents_processed": 12,
  "translations_scheduled": 24,
  "translations_skipped": 0,
  "translations_completed": 16,
  "translations_failed": 1,
  "reused": false,
  "created_at": "2026-07-15T18:00:00Z",
  "updated_at": "2026-07-15T18:01:30Z"
}

דוגמה

curl '{TRANSLATION_API_URL}/translation-jobs/<job-id>' \
  -H 'Authorization: Bearer <workos-jwt>'

שגיאות

• 401 Unauthorized — אסימון bearer חסר או לא חוקי
• 404 Not Found — המשימה אינה קיימת או שאינה נשמרת עוד

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