适用范围与准备

适用于代理管理、配置或其他有文档的接口在创建操作后返回201 Created。本文讲结果核对;不提供批量创建、充值或重复提交脚本,也不把一个状态码当成整个业务完成的证据。

先区分原因

201表示请求已经完成并产生一个或多个新资源;响应Location通常标识主要新资源,缺少该头时由请求目标URI标识。它与3xx跳转不同,也与202仅表示已接受处理不同。资源已创建仍不保证业务中的启用、分配或后续任务全部完成。

按顺序操作

  1. 先保留这一笔提交的时间、原请求目标、状态、返回资源ID及Location。若网页显示异常,先查已有结果,不立即再点创建或付款按钮。
  2. 按接口说明核对Location指向哪里。相对地址要按原请求地址解析;跨域地址必须确认是服务正式资源入口,不自动携带原Authorization或Cookie去陌生站点。
  3. 只有接口明确允许读取、且本人有相应权限时,查询新资源。核对资源ID、所属账户和预期字段;不要把另一次创建返回的ID或列表中的第一项当作本次结果。
  4. 若业务还要求资源变为可用状态,按其文档继续读取状态或等待通知。把“创建成功”和“可以使用”分别记录,不通过重复创建来催促后续处理。
响应需要继续核对
201 Created新资源身份和业务字段
Location随201返回新资源的位置,不自动等于重发原请求
202 Accepted异步任务最终结果
状态成功但正文不符接口契约、账户和实际资源

怎样确认有效

应能从本次响应追溯到正确的新资源,并确认用户要求的最终状态。客户端能解析JSON或跳到详情页只是中间步骤;没有核对资源归属时不能标记交付完成。

无效时恢复与下一步

结果不明时保留原响应和操作记录,联系服务支持按资源ID核对。不要盲目删除“疑似多余”资源或反复提交;确需撤销时按服务的明确撤销流程,由有权限的人处理。