列出翻译作业

按引擎、状态、触发方式或服务密钥查找作业,并通过游标分页获取结果。

列出组织中对调用者可见的作业:

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

响应包含作业摘要数组 data 和 meta.nextCursor。使用 nextCursor 继续分页,直到其值为 null;不能仅凭空页判断分页是否结束,仍需检查游标。

筛选条件 #

参数含义
engineIds要包含的引擎 ID。
statusesPending、Running、Completed、Failed 或 Cancelled。
triggersapi、cli、ci、github、payload 或 zendesk。
apiKeyIds服务密钥 ID。使用个人密钥创建的作业归属于用户。
limit1 到 100 之间的整数,默认值为 50。
cursor上一次响应返回的不透明游标。

要指定多个值,请重复传入数组参数,例如 statuses=Running&statuses=Failed。使用游标分页时,请保持筛选条件不变。作业按创建时间从新到旧返回;创建时间相同时,按作业 ID 排序。

摘要字段 #

每条摘要包含 id、organizationId、engineId、sourceLocale、trigger、status、createdAt、updatedAt 和 createdBy。状态为带标签的对象,例如 { "_tag": "Running" };失败状态还包含 message。

摘要不包含文档和输出文件。通过 id 获取作业,即可查看其文档键、目标语言区域、阶段进度和下载 URL。

请尽可能在自己的应用中保存创建作业时响应返回的 ID。列出作业有助于排查问题和恢复,但用于生成作业的源内容修订版本应保存在应用自身的记录中。