Zařaďte na pozadí překlad všech zveřejněných dokumentů z jedné nebo více komponentních schémat do sady cílových jazyků. Výsledky se vkládají nebo aktualizují v tabulce translations, jakmile se každý překlad dokončí.

Koncový bod: POST /translation Autorizace: Bearer JWT (WorkOS)

Tělo požadavku

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

* Uveďte buď schemaNames, nebo schemaName.

Zohledňují se pouze zveřejněné dokumenty s ne-null hodnotou zveřejněného obsahu.

Odpověď

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

Vrací:

• 202 Accepted, když jsou překlady zařazeny do fronty
• 200 OK, když jsou všechny překlady již aktuální
• existující aktivní úlohu, pokud už probíhá totožný požadavek

Možné stavy úlohy jsou:

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

Přeskakování aktuálních překladů

Každá dvojice dokument–jazyk uchovává hash SHA-256 zveřejněného obsahu zdrojového dokumentu.

Překlad se přeskočí, když jeho uložený zdrojový hash odpovídá aktuálnímu zveřejněnému obsahu. Díky tomu lze koncový bod volat opakovaně bez překládání nezměněného obsahu.

Pokud se zveřejněný obsah změní během aktivní totožné úlohy, služba nový požadavek odmítne. Odešlete jej znovu po dokončení aktivní úlohy.

Způsob zpracování

Překlad probíhá asynchronně po úvodní odpovědi.

• Práce je zpracovávána s omezeným paralelismem.
• Přechodná selhání se znovu zkoušejí s prodlevou (backoff).
• Úspěšné výsledky se ukládají ihned po dokončení.
• Jednotlivá selhání inference nebo uložení se zaznamenají k úloze.
• Částečně úspěšná úloha končí stavem completed_with_errors.

Příklad

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

Chyby

• 400 Bad Request — schémata nebo jazyky chybí, jazyk není podporovaný nebo dávka překračuje nakonfigurovaný limit
• 401 Unauthorized — chybí nebo je neplatný token Bearer
• 409 Conflict — odpovídající práce je aktivní, ale zveřejněný zdrojový obsah se změnil
• 500 Internal Server Error — zdrojové dokumenty se nepodařilo připravit nebo selhala databázová operace

Získání překladové úlohy

Získejte nejnovější průběh překladové úlohy.

Koncový bod: GET /translation-jobs/{job_id} Autorizace: Bearer JWT (WorkOS)

Odpověď

Odpověď používá stejný objekt úlohy jako POST /translation, pouze se aktualizovaným stavem a počty.

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

Příklad

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

Chyby

• 401 Unauthorized — chybí nebo je neplatný token Bearer
• 404 Not Found — úloha neexistuje nebo už není uchována

Překladové úlohy jsou v současnosti uchovávány v paměti. Stav úloh se ztratí při restartu překladové služby a nasazení s více instancemi vyžaduje lepkavé směrování.