Sett bakgrunnsoversettelse i kø for alle publiserte dokumenter fra ett eller flere komponentskjemaer til et sett med målspråk. Resultatene settes inn eller oppdateres i translations-tabellen etter hvert som oversettelsene fullføres.

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

Forespørselskropp

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

* Oppgi enten schemaNames eller schemaName.

Bare publiserte dokumenter med ikke-null publisert innhold tas med.

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

Returnerer:

• 202 Accepted når oversettelser er lagt i kø
• 200 OK når alle oversettelser allerede er oppdaterte
• den eksisterende aktive jobben når en identisk forespørsel allerede kjører

Mulige jobbstatuser er:

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

Hoppe over oppdaterte oversettelser

Hvert dokument–språk-par lagrer en SHA-256-hash av kildedokumentets publiserte innhold.

En oversettelse hoppes over når den lagrede kildehashen samsvarer med det gjeldende publiserte innholdet. Dette gjør det mulig å kalle endepunktet gjentatte ganger uten å oversette uendret innhold på nytt.

Hvis det publiserte innholdet endres mens en tilsvarende jobb er aktiv, avviser tjenesten den nye forespørselen. Send den inn på nytt etter at den aktive jobben er ferdig.

Behandlingsatferd

Oversettelsen kjører asynkront etter det første svaret.

• Arbeidet behandles med begrenset samtidighet.
• Forbigående feil forsøkes på nytt med tilbakeventing.
• Vellykkede resultater lagres etter hvert som de fullføres.
• Individuelle feil i inferens eller lagring registreres på jobben.
• En delvis vellykket jobb avsluttes med completed_with_errors.

Eksempel

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

Feil

• 400 Bad Request — skjemaer eller språk mangler, et språk støttes ikke, eller gruppen overskrider den konfigurerte grensen
• 401 Unauthorized — bearer-token mangler eller er ugyldig
• 409 Conflict — samsvarende arbeid er aktivt, men det publiserte kildeinnholdet er endret
• 500 Internal Server Error — kildedokumentene kunne ikke klargjøres, eller en databaseoperasjon mislyktes

Hent oversettelsesjobb

Hent den nyeste fremdriften for en oversettelsesjobb.

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

Svar

Svaret bruker det samme jobbobjektet som returneres av POST /translation, med oppdatert status og fremdriftstall.

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

Eksempel

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

Feil

• 401 Unauthorized — bearer-token mangler eller er ugyldig
• 404 Not Found — jobben finnes ikke eller lagres ikke lenger

Oversettelsesjobber lagres for øyeblikket i minnet. Jobbstatus går tapt når oversettelsestjenesten starter på nytt, og distribusjoner med flere instanser krever klebrig ruting.