接口说明
对指定id的云手机执行更新属性操作。任务执行成功且重启云手机后,更新的属性才能生效。 注意: 1. 本接口属于异步任务接口,返回结果只有任务id。查询该任务的执行状态需要客户配置回调信息,或者根据任务id调用“查询任务执行状态详情/列表”接口来实现;
URL
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/attributes/update
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
req
|
OpenapiCloudPhoneAttributeReq
|
是
|
req |
|
byte_os_mainkeys
|
integer(int32)
|
否
|
隐藏虚拟按键,默认为1。0为不隐藏,1为隐藏。 |
|
callbackUrl
|
string
|
否
|
回调url,如http://192.168.0.1:5556/api/callback,needCallback为true才能生效 |
|
disable_status_bar
|
integer(int32)
|
否
|
是否禁用状态栏,默认为0。1禁用,0不禁用。 |
|
gsm_operator_alpha
|
string
|
否
|
⽹络运营商名称,默认为CMCC |
|
gsm_operator_iso_country
|
string
|
否
|
⽹络运营商国家代码,默认为cn |
|
gsm_operator_numeric
|
string
|
否
|
⽹络提供商的标识码,默认为46000 |
|
gsm_sim_operator_alpha
|
string
|
否
|
SIM卡的运营商,默认为CMCC |
|
gsm_sim_operator_iso_country
|
string
|
否
|
SIM卡归属国家,默认为cn |
|
gsm_sim_operator_numeric
|
string
|
否
|
SIM卡提供商的标识码,默认为46000 |
|
id
|
string
|
是
|
云手机实例ID |
|
needAuth
|
boolean
|
否
|
是否需要鉴权 |
|
needCallback
|
boolean
|
否
|
是否需要回调 |
|
ro_byte_os_notification_disable
|
integer(int32)
|
否
|
是否禁用消息通知,默认为0。1禁用,0不禁用。 |
|
ro_byte_os_toast_enable
|
integer(int32)
|
否
|
是否启用Toast消息提示框,默认为0。1为启用,0为不启用。 |
|
ro_horizontal_screen
|
integer(int32)
|
否
|
是否横屏显示,默认为0。1为有横屏显示,0为没有横屏显示。 |
|
ro_install_auto
|
integer(int32)
|
否
|
是否在App安装时自动确认安装,默认为0。1为确认,0为不确认 |
|
ro_permission_changed
|
integer(int32)
|
否
|
是否在安装app时自动赋予App请求的所有权限,默认为0。1赋予,0不赋予。 |
|
sys_prop_imeid
|
string
|
否
|
MEID(Mobile Equipment Identifier)是用于标识CDMA(Code Division Multiple Access)移动设备的唯⼀标识符 |
|
sys_prop_writeimsi
|
string
|
否
|
IMSI(International Mobile Subscriber Identity,国际移动用户识别码) |
|
sys_prop_writephonenum
|
string
|
否
|
⼿机号码 |
|
sys_prop_writewifibssid
|
string
|
否
|
在⽆线局域⽹(WLAN)中⽤于唯⼀标识基本服务集(BSS)的MAC地址 |
|
sys_prop_writewifissid
|
string
|
否
|
⽆线⽹络名称 |
请求示例
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/attributes/update
{
"byte_os_mainkeys":0,
"disable_status_bar":1,
"id":"1895478838969253891",
"needCallback":true,
"callbackUrl":"http://192.168.0.1:5556/api/callback",
"needAuth":false
}
返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
OpenapiCloudphoneJobDto
|
响应体 |
|
errorCode
|
string
|
任务错误码 |
|
errorMsg
|
string
|
任务错误码说明 |
|
id
|
string
|
云手机ID |
|
jobId
|
string
|
任务ID |
|
errorCode
|
string
|
错误编码 |
|
errorMessage
|
string
|
错误信息 |
|
requestId
|
string
|
请求id |
|
state
|
string
|
状态值 |
返回示例
{
"errorCode":"00000000",
"errorMessage":"请求成功",
"requestId":"14ed88ea-9231-4ce9-92c4-97560e0b8835",
"state":"OK",
"body":{
"id":"1895478838969253891",
"jobId":"1900011392968523777",
"errorMsg":null,
"errorCode":null
}
}