Ievieto rindā fona tulkošanu visiem publicētajiem dokumentiem no vienas vai vairākām komponentu shēmām uz mērķa valodu kopu. Rezultāti tiek ievietoti vai atjaunināti tabulā translations pēc katra tulkojuma pabeigšanas.

Galapunkts: POST /translation Autentifikācija: Bearer JWT (WorkOS)

Pieprasījuma pamatteksts

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

• Norādiet vai nu schemaNames, vai schemaName.

Tiek ņemti vērā tikai publicētie dokumenti ar saturu, kas nav nulles vērtība.

Atbilde

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

Atgriež:

• 202 Accepted, kad tulkojumi ir ievietoti rindā
• 200 OK, kad visi tulkojumi jau ir aktuāli
• esošo aktīvo uzdevumu, ja identisks pieprasījums jau tiek izpildīts

Iespējamie uzdevuma statusi:

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

Aktuālo tulkojumu izlaišana

Katrs dokumenta un valodas pāris glabā avota dokumenta publicētā satura SHA-256 jaucējkodu.

Tulkojums tiek izlaists, ja saglabātais avota jaucējkods atbilst pašreizējam publicētajam saturam. Tas ļauj galapunktu izsaukt atkārtoti, netulkojot nemainītu saturu vēlreiz.

Ja publicētais saturs mainās, kamēr darbojas līdzvērtīgs uzdevums, pakalpojums noraida jauno pieprasījumu. Iesniedziet to vēlreiz pēc aktīvā uzdevuma pabeigšanas.

Apstrādes darbība

Tulkošana notiek asinhroni pēc sākotnējās atbildes.

• Darbs tiek apstrādāts ar ierobežotu paralēlismu.
• Pagaidu kļūmes tiek mēģināts novērst atkārtoti, izmantojot atkāpšanās intervālus.
• Veiksmīgie rezultāti tiek saglabāti pēc to pabeigšanas.
• Atsevišķas secināšanas vai saglabāšanas kļūmes tiek reģistrētas uzdevumā.
• Daļēji veiksmīgs uzdevums tiek pabeigts ar statusu completed_with_errors.

Piemērs

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

Kļūdas

• 400 Bad Request — trūkst shēmu vai valodu, valoda netiek atbalstīta vai pakete pārsniedz konfigurēto ierobežojumu
• 401 Unauthorized — bearer pilnvaras pilnvara nav norādīta vai nav derīga
• 409 Conflict — atbilstošs darbs ir aktīvs, bet publicētais avota saturs ir mainījies
• 500 Internal Server Error — avota dokumentus neizdevās sagatavot vai radās datubāzes darbības kļūme

Iegūt tulkošanas uzdevumu

Iegūstiet jaunāko tulkošanas uzdevuma progresu.

Galapunkts: GET /translation-jobs/{job_id} Autentifikācija: Bearer JWT (WorkOS)

Atbilde

Atbildē tiek izmantots tas pats uzdevuma objekts, ko atgriež POST /translation, taču ar atjauninātu statusu un progresa skaitītājiem.

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

Piemērs

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

Kļūdas

• 401 Unauthorized — bearer pilnvaras pilnvara nav norādīta vai nav derīga
• 404 Not Found — uzdevums neeksistē vai vairs netiek saglabāts

Pašlaik tulkošanas uzdevumi tiek saglabāti atmiņā. Pēc tulkošanas pakalpojuma restartēšanas uzdevuma statuss tiek zaudēts, un vairāku instanču izvietojumiem nepieciešama noturīga maršrutēšana.