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:

http
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEY

A 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âmetroSignificado
engineIdsIDs dos engines a incluir.
statusesPending, Running, Completed, Failed ou Cancelled.
triggersapi, cli, ci, github, payload ou zendesk.
apiKeyIdsIDs das chaves de serviço. As tarefas criadas com chaves pessoais são atribuídas ao usuário.
limitNúmero inteiro de 1 a 100; o valor padrão é 50.
cursorCursor 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.