Postavite v čakalno vrsto prevajanje v ozadju vseh objavljenih dokumentov iz ene ali več komponentnih shem v nabor ciljnih jezikov. Rezultati se po zaključku posameznega prevoda vstavijo ali posodobijo v tabeli translations.

Končna točka: POST /translation Overjanje: Bearer JWT (WorkOS)

Telo zahteve

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

* Navedite schemaNames ali schemaName.

Upoštevajo se samo objavljeni dokumenti z vsebino, ki ni null.

Odgovor

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

Vrne:

• 202 Accepted, ko so prevodi uvrščeni v čakalno vrsto
• 200 OK, ko so vsi prevodi že aktualni
• obstoječe aktivno opravilo, ko se enaka zahteva že izvaja

Možna stanja opravila so:

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

Preskakovanje aktualnih prevodov

Vsak par dokument–jezik vsebuje zgoščeno vrednost SHA-256 objavljene vsebine izvornega dokumenta.

Prevod se preskoči, ko se shranjena zgoščena vrednost vira ujema s trenutno objavljeno vsebino. Tako je mogoče končno točko klicati večkrat, ne da bi se nespremenjena vsebina znova prevajala.

Če se objavljena vsebina spremeni, medtem ko je aktivno enakovredno opravilo, storitev novo zahtevo zavrne. Počakajte, da se aktivno opravilo konča, nato zahtevo pošljite znova.

Način obdelave

Prevajanje se po začetnem odgovoru izvaja asinhrono.

• Delo se obdeluje z omejeno sočasnostjo.
• Začasne napake se ob ponovnih poskusih obravnavajo z zakasnitvijo.
• Uspešni rezultati se shranijo takoj, ko je posamezni prevod dokončan.
• Posamezne napake pri sklepanju ali shranjevanju se zabeležijo v opravilu.
• Delno uspešno opravilo se konča s stanjem completed_with_errors.

Primer

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

Napake

• 400 Bad Request — sheme ali jeziki manjkajo, jezik ni podprt ali paket presega nastavljeno omejitev
• 401 Unauthorized — žeton bearer manjka ali ni veljaven
• 409 Conflict — ujemajoče se delo je aktivno, vendar se je objavljena izvorna vsebina spremenila
• 500 Internal Server Error — izvornih dokumentov ni bilo mogoče pripraviti ali je operacija nad zbirko podatkov spodletela

Pridobivanje prevajalskega opravila

Pridobite najnovejši napredek prevajalskega opravila.

Končna točka: GET /translation-jobs/{job_id} Overjanje: Bearer JWT (WorkOS)

Odgovor

Odgovor uporablja isti objekt opravila, kot ga vrne POST /translation, vendar s posodobljenim stanjem in števci napredka.

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

Primer

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

Napake

• 401 Unauthorized — žeton bearer manjka ali ni veljaven
• 404 Not Found — opravilo ne obstaja ali se ne hrani več

Prevajalska opravila se trenutno hranijo v pomnilniku. Ob ponovnem zagonu prevajalske storitve se stanje opravila izgubi, pri namestitvah z več primerki pa je potrebno usmerjanje z ohranjanjem seje.