Listar tarefas de tradução
Encontre tarefas por motor, estado, gatilho ou chave de serviço e percorra os resultados com paginação por cursor.
Liste as tarefas de uma organização visíveis para quem faz o pedido:
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEYA resposta contém data, uma lista de resumos de tarefas, e meta.nextCursor. Siga nextCursor até que o 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 motores 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 utilizador. |
limit | Número inteiro de 1 a 100; o valor predefinido é 50. |
cursor | Cursor opaco devolvido na resposta anterior. |
Repita um parâmetro de lista para indicar vários valores, por exemplo statuses=Running&statuses=Failed. Mantenha os filtros inalterados ao seguir um cursor. As tarefas são devolvidas da mais recente para a mais antiga, com o ID da tarefa como critério de desempate quando a data e a hora de criação coincidem.
Campos do resumo #
Cada resumo contém id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt e createdBy. O estado é um objeto com uma etiqueta de tipo, como { "_tag": "Running" }; um estado de falha também inclui message.
Os resumos não incluem documentos nem ficheiros de saída. Obtenha uma tarefa através de id para consultar as chaves dos documentos, os idiomas de destino, o progresso das etapas e os URLs de transferência.
Sempre que possível, guarde na sua aplicação o ID devolvido 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 dos registos da sua aplicação.