Köa bakgrundsöversättning av alla publicerade dokument från ett eller flera komponentscheman till en uppsättning målspråk. Resultaten uppdateras eller infogas i tabellen translations när varje översättning slutförs.

Slutpunkt: POST /translation Autentisering: Bearer JWT (WorkOS)

Begärandekropp

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

* Ange antingen schemaNames eller schemaName.

Endast publicerade dokument med publicerat innehåll som inte är null beaktas.

Svar

{
  "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"
}

Returnerar:

• 202 Accepted när översättningarna är köade
• 200 OK när varje översättning redan är aktuell
• det befintliga aktiva jobbet när en identisk begäran redan körs

Möjliga jobbstatusar är:

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

Hoppa över aktuella översättningar

Varje dokument-språk-par lagrar en SHA-256-hash av källdokumentets publicerade innehåll.

En översättning hoppas över när den lagrade källhashen matchar det aktuella publicerade innehållet. Detta gör det möjligt att anropa slutpunkten upprepade gånger utan att översätta oförändrat innehåll på nytt.

Om det publicerade innehållet ändras medan ett motsvarande jobb är aktivt avvisar tjänsten den nya begäran. Skicka in den igen efter att det aktiva jobbet är slutfört.

Bearbetningsbeteende

Översättningen körs asynkront efter det initiala svaret.

• Arbetet bearbetas med begränsad samtidighet.
• Tillfälliga fel försöks om på nytt med backoff.
• Lyckade resultat sparas allteftersom de slutförs.
• Enskilda inferens- eller beständighetsfel registreras på jobbet.
• Ett delvis framgångsrikt jobb avslutas med completed_with_errors.

Exempel

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"]
  }'

Fel

• 400 Bad Request — scheman eller språk saknas, ett språk stöds inte eller batchen överskrider den konfigurerade gränsen
• 401 Unauthorized — bearer-token saknas eller är ogiltig
• 409 Conflict — matchande arbete är aktivt, men det publicerade källinnehållet har ändrats
• 500 Internal Server Error — källdokumenten kunde inte förberedas eller en databasoperation misslyckades

Hämta översättningsjobb

Hämta den senaste statusen för ett översättningsjobb.

Slutpunkt: GET /translation-jobs/{job_id} Autentisering: Bearer JWT (WorkOS)

Svar

Svaret använder samma jobbobjekt som returneras av POST /translation, med uppdaterad status och uppdaterade räknare.

{
  "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"
}

Exempel

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

Fel

• 401 Unauthorized — bearer-token saknas eller är ogiltig
• 404 Not Found — jobbet finns inte eller lagras inte längre

Översättningsjobb behålls för närvarande i minnet. Jobbstatus går förlorad när översättningstjänsten startas om, och distributioner med flera instanser kräver klistrig dirigering.