作业对象 API 和异步流程

使用作业对象描述的异步请求​

在进行异步运行的 API 调用之后，HTTP 响应代码 202 指示已成功验证并接受请求但尚未完成请求。该请求将作为后台任务处理，并在对客户端进行初始 HTTP 响应后继续运行。响应中包含用于锚定该请求的作业对象，包括其唯一标识符。

查询与 API 请求关联的作业对象​

HTTP 响应中返回的作业对象包含多个属性。可以查询状态属性以确定是否已成功完成请求。作业对象可以处于以下状态之一：

• 正常
• 警告
• 局部故障
• 错误

轮询作业对象以检测任务的终端状态（成功或失败）时，可以使用两种技术：

• 标准轮询请求：当前作业状态将立即返回。
• 长轮询请求：作业状态变为正常、错误或局部故障时。

异步请求中的步骤​

可以使用以下高度概括的过程来完成异步 API 调用：

1. 发出异步 API 调用。
2. 接收指示已成功接受请求的 HTTP 响应 202。
3. 从响应正文中提取作业对象的 ID。
4. 在循环中，等待作业对象到达终端状态正常、错误或局部故障。
5. 验证作业的终端状态并检索作业结果。