跳转到内容
API 参考
/
/
重试与完成矩阵
Last updated

Shared Resources 重试与完成矩阵

Shared Resources 共 26 个操作的重试、幂等与完成策略，其中 12 个记录了端点专属的业务错误码。

对于会改变状态的操作，HTTP 超时意味着结果未知，并不等于操作失败。重试前请先查询当前状态。

策略定义与其他产品见端点重试矩阵，机器可读版本见操作行为清单。

Shared Resources Local API

操作重试策略幂等性完成 / 恢复
POST /api/proxyInfo/page
queryProxyInfoPageUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/proxyInfo/add
addUsingPOST		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14023。
POST /api/proxyInfo/update
updateProxyUsingPOST		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14003, 14023。
POST /api/proxyInfo/delete
deleteProxyUsingPOST		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14017, 14024。
POST /api/envgroup/page
apiEnvgroupPagePost		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/envgroup/edit
apiEnvgroupEditPost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/envgroup/create
apiEnvgroupCreatePost		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/envgroup/delete
apiEnvgroupDeletePost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19064。
GET /api/envtag/all
apiEnvtagAllGet		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/envtag/create
apiEnvtagCreatePost		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/envtag/edit
apiEnvtagEditPost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/envtag/delete
apiEnvtagDeletePost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19105。
POST /api/webhook/config
apiWebhookConfigPost		可带上限的指数退避与抖动安全重试。按团队做 upsert；重复发送同一请求会收敛到同一份已保存配置。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：41001。

Shared Resources Open API

操作重试策略幂等性完成 / 恢复
POST /proxyInfo/page
queryProxyInfoPageUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /proxyInfo/add
addUsingPOST		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14023。
POST /proxyInfo/update
updateProxyUsingPOST		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14003, 14023。
POST /proxyInfo/delete
deleteProxyUsingPOST		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14017, 14024。
POST /envgroup/page
envgroupPagePost		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /envgroup/edit
envgroupEditPost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /envgroup/create
envgroupCreatePost		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /envgroup/delete
envgroupDeletePost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19064。
GET /envtag/all
envtagAllGet		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /envtag/create
envtagCreatePost		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /envtag/edit
envtagEditPost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /envtag/delete
envtagDeletePost		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19105。
POST /webhook/config
webhookConfigPost		可带上限的指数退避与抖动安全重试。按团队做 upsert；重复发送同一请求会收敛到同一份已保存配置。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：41001。

配置团队 Webhook

Overview