Volejte API z JavaScriptu

Přeložte JSON ze serveru Node.js, počkejte na výsledek a uložte ho do souboru.

K překladu strukturovaného obsahu ze serveru použijte nativní fetch. Tento příklad přeloží nadpis nastavení účtu z angličtiny do francouzštiny a uloží ho jako settings.fr.json. Potřebujete Node.js 22 nebo novější a engine s nakonfigurovaným překladovým modelem.

Přihlašovací údaje uchovávejte na serveru. Běhové prostředí React vykresluje katalogy bez klíče API.

Nastavte požadavek #

Vytvořte klíč API s oprávněním k překladu pro váš engine a zjistěte ID organizace a engine. Pro tento příklad použijte engine, u kterého je lidská kontrola neaktivní.

sh
export LINGO_API_KEY="YOUR_API_KEY"
export LINGO_ORGANIZATION_ID="YOUR_ORGANIZATION_ID"
export LINGO_ENGINE_ID="YOUR_ENGINE_ID"
export LINGO_REQUEST_ID="settings-v1-fr"

Při opakovaném odeslání tohoto požadavku použijte znovu stejnou hodnotu LINGO_REQUEST_ID. Pokud se změní zdroj, jazyky nebo jiné parametry požadavku, zvolte novou hodnotu.

Přeložte obsah a uložte výsledek #

Uložte tento kód jako translate.mjs:

js
import { writeFile } from "node:fs/promises";
import { setTimeout as delay } from "node:timers/promises";

const apiKey = process.env.LINGO_API_KEY;
const orgId = process.env.LINGO_ORGANIZATION_ID;
const engineId = process.env.LINGO_ENGINE_ID;
const requestId = process.env.LINGO_REQUEST_ID;
if (!apiKey || !orgId || !engineId || !requestId) {
  throw new Error("Set LINGO_API_KEY, LINGO_ORGANIZATION_ID, LINGO_ENGINE_ID, and LINGO_REQUEST_ID");
}

async function request(path, options = {}) {
  const response = await fetch(new URL(path, "https://api.lingo.dev"), {
    ...options,
    headers: { "X-API-Key": apiKey, ...options.headers },
    signal: AbortSignal.timeout(30_000),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  return response;
}

let job = await (
  await request(`/v2/organizations/${encodeURIComponent(orgId)}/localization/jobs`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "Idempotency-Key": requestId },
    body: JSON.stringify({
      engineId,
      sourceLocale: "en",
      targetLocales: ["fr"],
      documents: [
        {
          key: "settings.json",
          format: { type: "json" },
          source: { content: { heading: "Account settings" } },
        },
      ],
    }),
  })
).json();
await writeFile("job.json", JSON.stringify({ id: job.id, requestId }, null, 2));
if (job.uploads.length) throw new Error("Upload the missing artifacts before starting");

const jobPath = `/v2/localization/jobs/${encodeURIComponent(job.id)}`;
job = await (await request(`${jobPath}/start`, { method: "POST" })).json();

const deadline = Date.now() + 120_000;
while (["Pending", "Running"].includes(job.status._tag)) {
  if (Date.now() >= deadline) throw new Error(`Still waiting for ${job.id}; keep job.json and check again later`);
  await delay(2000);
  job = await (await request(jobPath)).json();
}

const target = job.documents
  .find((document) => document.key === "settings.json")
  ?.targets.find((item) => item.locale === "fr");
if (target?.status._tag !== "Completed") {
  throw new Error(`Translation did not complete: ${JSON.stringify(job.status)}`);
}
const translated = await (await request(target.status.downloadUrl)).json();
if (typeof translated.heading !== "string") throw new Error("The result is missing its heading");
await writeFile("settings.fr.json", JSON.stringify(translated, null, 2) + "\n");
console.log("Saved settings.fr.json");

Spusťte node translate.mjs, pak otevřete settings.fr.json a zkontrolujte francouzský nadpis. Program uloží ID úlohy před zahájením zpracování a výsledek stáhne až po dokončení cílového překladu.

Pomocná funkce pro požadavky zkontroluje stav HTTP ještě před přečtením odpovědi. Při chybě HTTP určete podle stavu a podrobností o problému, co je potřeba opravit. K chybě sítě nebo vypršení časového limitu může dojít i poté, co server přijme úlohu ke zpracování.

Pokračujte po přerušení #

Přečtěte ID ze souboru job.json a načtěte úlohu, abyste mohli dál kontrolovat její stav. Pokud se odpověď na vytvoření úlohy ztratila před uložením souboru, zopakujte stejný požadavek se stejným klíčem idempotence. Opakováním /start navážete na stejnou úlohu. Vypršení časového limitu ukončí čekání programu, ale nezruší zpracování na serveru.

Pro aplikaci, která zpracovává mnoho požadavků nebo čeká na lidskou kontrolu, vytvořte překladové workflow, které ukládá ID úloh a revize zdroje a shromažďuje výsledky v procesu na pozadí. Část Překlad souborů popisuje nahrávání artefaktů a dílčí výsledky pro více jazyků.