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

Browser 重试与完成矩阵

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

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

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

Browser Local API

操作重试策略幂等性完成 / 恢复
POST /api/env/start
startBrowserProfileUsingPOST		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19099, 19143。
POST /api/env/close
closeBrowserProfileLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/create/quick
createBrowserProfileQuickLocal		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14023, 19002, 19063, 19064, 19104, 19106, 19107, 19108, 19111, 19112。
POST /api/env/create/advanced
createBrowserProfileAdvancedLocal		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175。
POST /api/env/update
updateBrowserProfileLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193。
POST /api/env/removeToRecycleBin/batch
batchDeleteBrowserProfilesUsingPOST		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/page
listBrowserProfilesUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/detail
getBrowserProfileDetailsUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
GET /api/env/advanced/ua/versions
listAdvancedUaVersionsLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/advanced/ua/get
getBrowserProfileUAUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/base/resolution/list
listResolutionsUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
GET /api/system/platform/list
listSystemPlatformsLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/lock/query
queryBrowserLockStatusUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/base/list
listTimezoneAndLanguageUsingPOST		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/removeLocalCache
clearLocalProfileCacheUsingPOST		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/cache/cleanCloud
cleanCloudCacheLocal		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19039, 19149。
POST /api/env/fingerprint/refresh
refreshFingerprintUsingPOST		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193。
POST /api/env/status
getBrowserProfileStatusLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/getAllScreen
getAllBrowserScreensLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/arrangeWindows
arrangeBrowserWindowsLocal		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/setGroup/batch
setBrowserGroupsBatchLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/setProxy/batch
setBrowserProxiesBatchLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14023, 19106, 19193。
POST /api/env/setRemark/batch
setBrowserRemarksBatchLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/closeAll
closeAllBrowserProfilesLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/getAllProcessIds
getAllBrowserProcessIdsLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/getAllDebugInfo
getAllBrowserDebugInfoLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/base/mobile/devices
listMobileDeviceModelsLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/env/core/download
downloadBrowserKernelsLocal		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/cloudbrowser/start
startCloudRuntimeLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。轮询 POST /cloudbrowser/page 直到运行实例达到预期状态。 已记录的业务错误码：19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037。
POST /api/cloudbrowser/stop
stopCloudRuntimeLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。轮询 POST /cloudbrowser/page 直到运行实例消失或已停止。 已记录的业务错误码：40002, 40006, 40008, 40020。
POST /api/cloudbrowser/page
pageCloudRuntimesLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/cloudbrowser/connect
connectCloudRuntimeLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：40008, 40009, 40010。

Browser Open API

操作重试策略幂等性完成 / 恢复
POST /env/create/quick
quickCreateBrowserProfileOpenApi		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14023, 19002, 19063, 19064, 19104, 19106, 19107, 19108, 19111, 19112。
POST /env/create/advanced
advancedCreateBrowserProfileOpenApi		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175。
POST /env/update
updateBrowserProfileOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193。
POST /env/page
listBrowserProfilesOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/detail
getBrowserProfileDetailOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/removeToRecycleBin/batch
batchRemoveBrowserProfilesOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/lock/query
queryBrowserProfileLockOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/setGroup/batch
batchSetBrowserProfileGroupOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/setProxy/batch
batchSetBrowserProfileProxyOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：14023, 19106, 19193。
POST /env/setRemark/batch
batchSetBrowserProfileRemarkOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /cloudbrowser/start
startCloudRuntimeOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。轮询 POST /cloudbrowser/page 直到运行实例达到预期状态。 已记录的业务错误码：19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037。
POST /cloudbrowser/stop
stopCloudRuntimeOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。轮询 POST /cloudbrowser/page 直到运行实例消失或已停止。 已记录的业务错误码：40002, 40006, 40008, 40020。
POST /cloudbrowser/page
pageCloudRuntimesOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /cloudbrowser/connect
connectCloudRuntimeOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：40008, 40009, 40010。
POST /env/advanced/ua/versions
listKernelVersionsOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/advanced/ua/get
getUserAgentOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/base/resolution/list
listResolutionsOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/base/list
listTimezonesAndLanguagesOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/base/mobile/devices
listMobileDevicesOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /env/fingerprint/refresh
refreshFingerprintOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193。
POST /env/cache/cleanCloud
cleanCloudCacheOpenApi		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：19039, 19149。

清除云端缓存

Overview