Zaradí na pozadí preklad všetkých publikovaných dokumentov z jednej alebo viacerých schém komponentov do množiny cieľových jazykov. Výsledky sa postupne vkladajú alebo aktualizujú do tabuľky translations, keď sa každý preklad dokončí.

Koncový bod: POST /translation Autentifikácia: Bearer JWT (WorkOS)

Telo požiadavky

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

* Poskytnite buď schemaNames, alebo schemaName.

Zohľadňujú sa iba publikované dokumenty s neprázdnym publikovaným obsahom.

Odpoveď

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

Vracia:

• 202 Accepted — keď sú preklady zaradené do frontu
• 200 OK — keď sú všetky preklady už aktuálne
• existujúcu aktívnu úlohu, keď už identická požiadavka beží

Možné stavy úlohy sú:

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

Vynechanie aktuálnych prekladov

Každá dvojica dokument–jazyk uchováva hash SHA-256 publikovaného obsahu zdrojového dokumentu.

Preklad sa vynechá, keď uložený hash zdroja zodpovedá aktuálnemu publikovanému obsahu. Vďaka tomu je možné koncový bod vyvolať opakovane bez prekladania nezmeneného obsahu.

Ak sa publikovaný obsah zmení počas toho, ako je aktívna ekvivalentná úloha, služba novú požiadavku odmietne. Odošlite ju znova po dokončení aktívnej úlohy.

Priebeh spracovania

Preklad prebieha asynchrónne po úvodnej odpovedi.

• Práca sa spracúva s obmedzenou súbežnosťou.
• Dočasné zlyhania sa opakujú s odstupňovaným oneskorením.
• Úspešné výsledky sa priebežne ukladajú.
• Jednotlivé zlyhania inferencie alebo ukladania sa zaznamenávajú pri úlohe.
• Čiastočne úspešná úloha sa ukončí so stavom completed_with_errors.

Prí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 — chýbajú schémy alebo jazyky, jazyk nie je podporovaný alebo dávka prekračuje nakonfigurovaný limit
• 401 Unauthorized — chýba bearer token alebo je neplatný
• 409 Conflict — zodpovedajúca práca je aktívna, ale publikovaný zdrojový obsah sa zmenil
• 500 Internal Server Error — zdrojové dokumenty sa nepodarilo pripraviť alebo zlyhala databázová operácia

Získanie úlohy prekladu

Získajte najnovší priebeh úlohy prekladu.

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

Odpoveď

Odpoveď používa rovnaký objekt úlohy ako odpoveď POST /translation, s aktualizovaným stavom a počtami priebehu.

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

Príklad

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

Chyby

• 401 Unauthorized — chýba bearer token alebo je neplatný
• 404 Not Found — úloha neexistuje alebo sa už neuchováva

Úlohy prekladu sa momentálne uchovávajú v pamäti. Stav úlohy sa stratí pri reštarte prekladovej služby a nasadenia s viacerými inštanciami vyžadujú sticky routing.