Получить одно задание

Получите переведённый результат для одной локали и историю по каждому этапу его получения.

К этому эндпоинту обращаются, когда у вас уже есть jobId — он приходит в ответе 202 from create, передаётся через webhook или указан в группе заданий. Эндпоинт группы показывает, сколько локалей уже готово. Этот эндпоинт показывает, что получилось для одной конкретной локали и что происходило по пути.

GET /jobs/localization/:jobId

В этом и есть смысл всей страницы. Ответ группы — это табло: счётчики и статусы по заданиям, о них рассказано на странице группы заданий. А одно задание — это полная история по одной локали: переведённый outputData, финальный status, любые warnings и цепочка steps[] всех этапов, которые выполнил пайплайн. Когда вам нужно записать немецкий текст в свою базу данных, именно этот вызов его и вернёт.

Аутентификация#

Передайте API-ключ в заголовке X-API-Key. Ключи привязаны к организации и дают доступ ко всем движкам в её пределах. Подробности см. в разделе Authentication.

Ответ#

Поле outputData повторяет структуру входного data: все строковые значения переведены, а все нестроковые значения (числа, булевы значения, null) сохранены на своих местах. Те же ключи, та же вложенность, тот же порядок в массивах — меняются только строки.

{
  "id": "ljb_A1b2C3d4E5f6G7h8",
  "groupId": "ljg_A1b2C3d4E5f6G7h8",
  "targetLocale": "de",
  "status": "completed",
  "outputData": {
    "id": "course_101",
    "title": "Einführung in maschinelles Lernen",
    "steps": [
      { "heading": "Was ist ML?", "body": "Maschinelles Lernen ist ein Teilbereich der künstlichen Intelligenz." },
      { "heading": "Überwachtes Lernen", "body": "Trainieren eines Modells mit gelabelten Daten." }
    ],
    "metadata": { "author": "Dr. Smith", "difficulty": "beginner" }
  },
  "errorMessage": null,
  "warnings": [],
  "callbackStatus": "delivered",
  "createdAt": "2026-03-16T10:30:00.000Z",
  "startedAt": "2026-03-16T10:30:01.000Z",
  "completedAt": "2026-03-16T10:30:04.000Z",
  "steps": [
    {
      "stepId": "localize",
      "type": "action",
      "status": "completed",
      "errorMessage": null,
      "externalRefType": null,
      "externalRefId": null,
      "externalRefUrl": null,
      "createdAt": "2026-03-16T10:30:01.000Z",
      "startedAt": "2026-03-16T10:30:01.000Z",
      "completedAt": "2026-03-16T10:30:04.000Z"
    }
  ]
}

Блок metadata выше сохранился без изменений: Dr. Smith и beginner — это нестроковые листья, которые движок оставил как есть. Полученный outputData соответствует форме отправленных данных, поэтому тот же код, который собрал payload, может обработать и перевод.

Значения статуса задания#

Задание переходит из queued в processing, а затем — ровно в одно финальное состояние. Прежде чем читать что-либо ещё, проверьте status — оно показывает, какие поля заполнены.

Массив steps#

steps[] — это история этапов одного задания: по одной записи на каждый этап, который выполнил движок, в порядке выполнения. Каждое задание содержит как минимум этап localize, потому что базовый перевод выполняется всегда. Каждый включённый необязательный этап пайплайна добавляет ещё одну запись. Поэтому задание без дополнительных этапов содержит только один этап localize, а задание с включёнными pre-edit и back-translation — уже три.

Именно это делает задание проверяемым, а не чёрным ящиком. Вам не нужно верить, что этап отработал, — вы читаете его запись: какой это был этап (stepId), был ли он completed, failed или skipped, сколько стоил (costUsd) и когда начался и закончился. Для этапов с ручной проверкой externalRef* указывает на внешнюю запись.

"steps": [
  {
    "stepId": "preEdit",
    "type": "action",
    "status": "completed",
    "errorMessage": null,
    "costUsd": 0.0012,
    "createdAt": "2026-03-16T10:30:01.000Z",
    "completedAt": "2026-03-16T10:30:02.000Z"
  },
  {
    "stepId": "localize",
    "type": "action",
    "status": "completed",
    "errorMessage": null,
    "costUsd": 0.0184,
    "createdAt": "2026-03-16T10:30:02.000Z",
    "completedAt": "2026-03-16T10:30:05.000Z"
  }
]

Запись failed здесь не обязательно означает сбой всего задания. Когда некритичный этап завершается с ошибкой, в его записи steps[] указано failed, тот же сбой появляется в верхнеуровневом поле задания warnings, а само задание всё равно доходит до состояния completed_with_warnings с полным outputData. Полная структура записи — каждое поле, каждый stepId, семантика completed/failed/skipped — описана на одной канонической странице: Observe pipeline runs. Эта страница показывает, где найти эти данные у задания; та страница задаёт спецификацию.

Чтение завершённого задания#

Обычно клиент сначала ветвит логику по status, при успехе записывает outputData, а при сбое пишет в лог errorMessage. Вызов ниже можно просто скопировать и вставить — он вернёт payload, показанный выше.

const jobId = "ljb_A1b2C3d4E5f6G7h8";
const response = await fetch(`https://api.lingo.dev/jobs/localization/${jobId}`, {
  headers: { "X-API-Key": process.env.LINGO_API_KEY },
});

const job = await response.json();

switch (job.status) {
  case "completed":
  case "completed_with_warnings":
    // outputData is populated; warnings may carry non-critical stage failures
    await db.content.update({
      where: { id: job.outputData.id },
      data: { [`content_${job.targetLocale}`]: job.outputData },
    });
    if (job.warnings.length) console.warn(job.targetLocale, job.warnings);
    break;
  case "failed":
    console.error(`${job.targetLocale} failed: ${job.errorMessage}`);
    break;
  default:
    // queued or processing - nothing to read yet; also catches future states
    break;
}

Если этот эндпоинт возвращает ошибку — неизвестный jobId, отсутствующий ключ, — он использует стандартную JSON-модель ошибок. См. Errors and status codes.

Следующие шаги#