Stavlja u red čekanja pozadinski prijevod svih objavljenih dokumenata iz jedne ili više komponentnih shema na skup ciljnih jezika. Rezultati se umeću ili ažuriraju u tablici translations nakon dovršetka svakog prijevoda.

Krajnja točka: POST /translation Autentikacija: Bearer JWT (WorkOS)

Tijelo zahtjeva

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

* Navedite ili schemaNames ili schemaName.

U obzir se uzimaju samo objavljeni dokumenti s ne-nultim objavljenim sadržajem.

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

Vraća:

• 202 Accepted kada se prijevodi stave u red čekanja
• 200 OK kada je svaki prijevod već aktualan
• postojeći aktivni posao kada je identičan zahtjev već u tijeku

Mogući statusi posla su:

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

Preskakanje aktualnih prijevoda

Svaki par dokument–jezik pohranjuje SHA-256 hash-vrijednost objavljenog sadržaja izvornog dokumenta.

Prijevod se preskače kada njegova pohranjena hash-vrijednost izvora odgovara trenutačnom objavljenom sadržaju. To omogućuje višestruko pozivanje krajnje točke bez ponovnog prevođenja nepromijenjenog sadržaja.

Ako se objavljeni sadržaj promijeni dok je ekvivalentan posao aktivan, usluga odbija novi zahtjev. Pošaljite ga ponovno nakon dovršetka aktivnog posla.

Ponašanje pri obradi

Prevođenje se izvršava asinkrono nakon početnog odgovora.

• Posao se obrađuje uz ograničenu istodobnost.
• Privremene pogreške ponovno se pokušavaju obraditi uz postupno povećanje čekanja.
• Uspješni rezultati pohranjuju se nakon dovršetka.
• Pojedinačne pogreške zaključivanja ili pohrane bilježe se na poslu.
• Djelomično uspješan posao završava statusom completed_with_errors.

Primjer

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

Pogreške

• 400 Bad Request — sheme ili jezici nedostaju, jezik nije podržan ili paket premašuje konfigurirano ograničenje
• 401 Unauthorized — token bearer nedostaje ili nije valjan
• 409 Conflict — odgovarajući posao je aktivan, ali se objavljeni izvorni sadržaj promijenio
• 500 Internal Server Error — izvorni dokumenti nisu se mogli pripremiti ili operacija nad bazom podataka nije uspjela

Dohvaćanje posla prevođenja

Dohvaća najnoviji napredak posla prevođenja.

Krajnja točka: GET /translation-jobs/{job_id} Autentikacija: Bearer JWT (WorkOS)

Odgovor

Odgovor koristi isti objekt posla koji vraća POST /translation, s ažuriranim statusom i brojačima napretka.

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

Primjer

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

Pogreške

• 401 Unauthorized — token bearer nedostaje ili nije valjan
• 404 Not Found — posao ne postoji ili se više ne zadržava

Poslovi prevođenja trenutačno se zadržavaju u memoriji. Status posla gubi se pri ponovnom pokretanju usluge prevođenja, a implementacije s više instanci zahtijevaju ljepljivo usmjeravanje.