Получить список заданий на перевод
Находите задания по движку, статусу, триггеру или служебному ключу и переходите по страницам с помощью курсора.
Получите список заданий организации, доступных вызывающей стороне:
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEYОтвет содержит data — массив сводок по заданиям — и meta.nextCursor. Переходите по страницам с помощью nextCursor, пока его значение не станет null. Даже если страница пуста, курсор всё равно нужно проверить.
Фильтры #
| Параметр | Описание |
|---|---|
engineIds | ИД движков, задания которых нужно включить в список. |
statuses | Pending, Running, Completed, Failed или Cancelled. |
triggers | api, cli, ci, github, payload или zendesk. |
apiKeyIds | ИД служебных ключей. Задания, созданные с личным ключом, привязаны к пользователю. |
limit | Целое число от 1 до 100. По умолчанию — 50. |
cursor | Непрозрачный курсор из предыдущего ответа. |
Чтобы передать несколько значений, повторите параметр массива, например statuses=Running&statuses=Failed. Не меняйте фильтры при переходе по страницам с помощью курсора. Задания возвращаются от новых к старым. Если время создания совпадает, порядок определяется ИД задания.
Поля сводки #
Каждая сводка содержит id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt и createdBy. Статус — это объект с меткой типа, например { "_tag": "Running" }. Статус сбоя также содержит message.
Сводки не содержат документов и выходных файлов. Получите задание по id, чтобы узнать ключи документов, целевые локали, ход выполнения этапов и URL для скачивания.
По возможности сохраняйте в своём приложении ИД из ответа на запрос создания задания. Список заданий полезен для поиска причин проблем и восстановления, но версию исходных данных, на основе которой создано задание, нужно хранить в записях вашего приложения.