Listar tarefas de tradução
Encontre tarefas por engine, estado, gatilho ou chave de serviço e navegue pelos resultados com paginação por cursor.
Liste as tarefas de uma organização visíveis para quem faz a chamada:
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEYA resposta contém data, um array de resumos de tarefas, e meta.nextCursor. Siga nextCursor até que seu valor seja null; uma página vazia, por si só, não dispensa a verificação do cursor.
Filtros #
| Parâmetro | Significado |
|---|---|
engineIds | IDs dos engines a incluir. |
statuses | Pending, Running, Completed, Failed ou Cancelled. |
triggers | api, cli, ci, github, payload ou zendesk. |
apiKeyIds | IDs das chaves de serviço. As tarefas criadas com chaves pessoais são atribuídas ao usuário. |
limit | Número inteiro de 1 a 100; o valor padrão é 50. |
cursor | Cursor opaco retornado na resposta anterior. |
Para informar vários valores em um parâmetro de array, repita o parâmetro, por exemplo, statuses=Running&statuses=Failed. Mantenha os filtros inalterados ao seguir um cursor. As tarefas são retornadas da mais recente para a mais antiga, usando o ID da tarefa como critério de desempate quando os horários de criação são iguais.
Campos do resumo #
Cada resumo contém id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt e createdBy. O estado é um objeto com um discriminador, como { "_tag": "Running" }; um estado de falha também inclui message.
Os resumos não incluem documentos nem arquivos de saída. Recupere uma tarefa por id para obter as chaves dos documentos, os idiomas de destino, o progresso das etapas e as URLs de download.
Sempre que possível, armazene na sua aplicação o ID retornado na resposta de criação. A listagem é útil para investigação e recuperação, mas a revisão de origem que gerou uma tarefa deve constar nos registros da sua aplicação.