资源 · 107

异步API任务

接受请求不能证明工作已完成。

已更新 · 2 min

本指南有助于实现的目标

  • 定义状态与权限
  • 恢复追踪
  • 确认最终结果

快速检查

  • 202能证明任务最终完成吗?
  • 取消会清除已产生的影响吗?

分步指南

  1. 1

    定义状态与权限

    区分已接受、排队、运行、完成、失败和请求取消。HTTP 202不保证成功。按账号检查状态、结果和取消权限;标识符不能替代授权。

    账号、操作和可复用标识符

  2. 2

    恢复追踪

    保留已有引用。规定查询间隔、持续时间、过期和状态缺失时的处理。如果支持防重复,应说明适用范围,并在重发前测试响应丢失。

    状态、时间、间隔和过期

  3. 3

    确认最终结果

    测试处理或发布期间取消、执行进程失败和结果过期。核实剩余影响,并在终态停止查询。

    产出、错误、取消和剩余影响

可重复使用的工作表

填写您已授权的观察结果。 这些字段是工作模板,而非观察结果。

字段待记录信息
引用账号、操作和可复用标识符
追踪状态、时间、间隔和过期
结果产出、错误、取消和剩余影响
验收一个获授权任务及中断后核实的结果

虚构示例

示例情境

虚构示例:导出任务的接受响应丢失,用户再次尝试。

决策及预期证据

测试重试契约是否返回已有任务。若没有这种保证,创建新任务前须核实请求;界面不能证明任务只执行一次。

管理指标

指标衡量内容首要行动
停滞任务规定时间内没有更新的请求分配审查、恢复或关闭
恢复未创建新任务而恢复的追踪调查重启和重复

常见错误

    常见问题解答

    202能证明任务最终完成吗?

    不能。它表示接受处理,而非最终结果。应查询操作状态。

    取消会清除已产生的影响吗?

    不一定。确认最终状态,并核对已经存在的影响。

    官方参考文献

    参考文献支持该方法。 请根据您的实际情况调整检查;它们并非认证。 原始参考文献标题和源文档可能使用其他语言。

    参考资料查阅日期 .