Į eilę įtraukite visų paskelbtų dokumentų vertimą fone iš vienos ar kelių komponentų schemų į pasirinktų tikslinių kalbų rinkinį. Kiekvienam vertimui baigiantis, rezultatai įterpiami arba atnaujinami lentelėje translations.

Galutinis taškas: POST /translation Autentikacija: Bearer JWT (WorkOS)

Užklausos turinys

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

* Pateikite schemaNames arba schemaName.

Svarstomi tik paskelbti dokumentai, kurių paskelbtas turinys nėra tuščias.

Atsakymas

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

Grąžina:

• 202 Accepted, kai vertimai įtraukti į eilę
• 200 OK, kai visi vertimai jau yra atnaujinti
• esamą aktyvų darbą, kai identiška užklausa jau vykdoma

Galimos darbo būsenos yra:

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

Esamų vertimų praleidimas

Kiekviena dokumento ir kalbos pora saugo SHA-256 maišos reikšmę, gautą iš paskelbto šaltinio dokumento turinio.

Vertimas praleidžiamas, kai jo saugoma šaltinio maišos reikšmė sutampa su dabartiniu paskelbtu turiniu. Taip šį galutinį tašką galima kviesti pakartotinai neperverčiant nepakitusio turinio.

Jei paskelbtas turinys keičiasi tuo metu, kai vykdomas lygiavertis darbas, paslauga atmeta naują užklausą. Pateikite ją iš naujo, kai aktyvus darbas baigsis.

Apdorojimo elgsena

Vertimas vykdomas asinchroniškai po pradinio atsakymo.

• Darbas apdorojamas ribotu lygiagretumu.
• Laikini gedimai kartojami su atidėjimu.
• Sėkmingi rezultatai išsaugomi jiems užbaigus.
• Pavieniai inferencijos ar išsaugojimo gedimai užfiksuojami darbe.
• Iš dalies sėkmingas darbas baigiamas būsena completed_with_errors.

Pavyzdys

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

Klaidos

• 400 Bad Request — trūksta schemų arba kalbų, kalba nepalaikoma arba paketas viršija nustatytą limitą
• 401 Unauthorized — trūksta „bearer“ žetono arba jis neteisingas
• 409 Conflict — atitinkamas darbas jau aktyvus, tačiau paskelbto šaltinio turinys pasikeitė
• 500 Internal Server Error — nepavyko parengti šaltinio dokumentų arba įvyko duomenų bazės operacijos klaida

Gauti vertimo darbą

Gaukite naujausią vertimo darbo eigą.

Galutinis taškas: GET /translation-jobs/{job_id} Autentikacija: Bearer JWT (WorkOS)

Atsakymas

Atsakyme naudojamas tas pats darbo objektas, kurį grąžina POST /translation, tik su atnaujinta būsena ir eigos skaitikliais.

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

Pavyzdys

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

Klaidos

• 401 Unauthorized — trūksta „bearer“ žetono arba jis neteisingas
• 404 Not Found — darbas neegzistuoja arba nebėra saugomas

Vertimo darbai šiuo metu saugomi atmintyje. Kai vertimo paslauga paleidžiama iš naujo, darbo būsena prarandama, o kelių egzempliorių diegimams reikalingas lipnusis maršrutizavimas.