重置云手机

API 参考

重置云手机

Request

数据清理警告： 重置会清理手机数据和应用安装记录，并终止正在执行的 AI 任务。请先备份所需数据；该操作不同于一键新机。

通过 id 操作单台云手机。调用方须有该手机的操作权限；手机须已激活、未释放、不在转移中、处于开机状态（envStatus=4），且未被其他成员占用。成功返回 data: null，不返回任务 ID，仅表示提交成功，不表示操作完成。限时轮询 /api/cloudphone/info 或 /api/cloudphone/page：处理中为 envStatus=5，成功恢复为 4，回调失败变为 2。若已订阅，可接收 cloud_phone.reset Webhook 最终结果。接口无幂等键：超时后先查询状态再决定是否重试，完成后再次调用可能重复执行。

已记录的业务错误码：33300, 33301, 33311, 33321, 33325, 33359, 33382。各错误码的含义见 Error Codes。任何接口还可能返回通用错误码。

Bodyapplication/jsonrequired

idstringrequired

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/reset \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1596527092376632"
  }'

Responses

成功

Bodyapplication/json

codeintegerrequired

返回结果代码 0：正常；其他代码均为例外情况。

msgstring or nullrequired

错误信息

requestIdstringrequired

操作请求 ID

datanullrequired

Response

{
  "code": 0,
  "msg": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d",
  "data": null
}