列出翻译作业
按引擎、状态、触发方式或服务密钥查找作业,并通过游标分页获取结果。
列出组织中对调用者可见的作业:
http
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEY响应包含作业摘要数组 data 和 meta.nextCursor。使用 nextCursor 继续分页,直到其值为 null;不能仅凭空页判断分页是否结束,仍需检查游标。
筛选条件 #
| 参数 | 含义 |
|---|---|
engineIds | 要包含的引擎 ID。 |
statuses | Pending、Running、Completed、Failed 或 Cancelled。 |
triggers | api、cli、ci、github、payload 或 zendesk。 |
apiKeyIds | 服务密钥 ID。使用个人密钥创建的作业归属于用户。 |
limit | 1 到 100 之间的整数,默认值为 50。 |
cursor | 上一次响应返回的不透明游标。 |
要指定多个值,请重复传入数组参数,例如 statuses=Running&statuses=Failed。使用游标分页时,请保持筛选条件不变。作业按创建时间从新到旧返回;创建时间相同时,按作业 ID 排序。
摘要字段 #
每条摘要包含 id、organizationId、engineId、sourceLocale、trigger、status、createdAt、updatedAt 和 createdBy。状态为带标签的对象,例如 { "_tag": "Running" };失败状态还包含 message。
摘要不包含文档和输出文件。通过 id 获取作业,即可查看其文档键、目标语言区域、阶段进度和下载 URL。
请尽可能在自己的应用中保存创建作业时响应返回的 ID。列出作业有助于排查问题和恢复,但用于生成作业的源内容修订版本应保存在应用自身的记录中。