跳转到内容
API 参考
/
/
/
创建云手机

创建云手机

Request

Bodyapplication/jsonrequired
skuIdstringrequired

云手机型号

skuId:10002 型号:Android 12

skuId:10013 型号:Android 13

skuId:10005 型号:Android 14

skuId:10004 型号:Android 15

skuId:10014 型号:Android 15A

有关型号参数的详细说明，请参阅附录。

quantityinteger, [ 1 .. 10 ]required

创建的云手机数量。取值范围：[1-10]

envRemarkstring, <= 1500 characters

环境备注（限1500字）

automaticGeoboolean

是否自动匹配地理位置。默认值：true

automaticLanguageboolean

是否自动匹配语言。默认值：true

automaticLocationboolean

是否自动匹配位置（时区、国家/地区）。默认值：true

countrystring

国家/地区，例如美国。有关国家/地区代码的详细信息，请参阅附录。

timezonestring

时区，例如：America/New_York

languagestring

语言，例如 en-US

altitudeinteger
latitudenumber

纬度。例如：22.309182

longitudenumber

经度。例如：114.176817

phoneNumberstring

自定义您的电话号码。格式要求：必须以“+”号开头，国家代码必须为 1-3 位数字（不包括 86），总长度为 8-14 位数字，并且只能包含“+”号和数字。

brandstring

设备品牌，您可以通过 https://guide.morelogin.com/api-reference/local-api/local-api/cloud-phone/paths/~1api~1cloudphone~1brand~1models/post 接口进行查询。

modelIdnumber

设备型号 ID，您可以通过 https://guide.morelogin.com/api-reference/local-api/local-api/cloud-phone/paths/~1api~1cloudphone~1brand~1models/post 接口进行查询。

proxyIdinteger, (int64)

代理 ID

tagsArray of strings

环境标签名称，当标签值为空时，不进行任何自定义设置；当输入内容时，将保存最新值。

groupIdinteger, (int64)

Environment group ID

groupNamestring, <= 50 characters

分组名称（最多50个字符）。如果提供了该参数，系统会先检查 groupId：如果找到有效分组则使用该分组；否则按 groupName 查找。如果存在同名分组则引用该分组；如果不存在则新建分组。每个团队最多限制1000个分组。

POST
/api/cloudphone/create
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/create \
  -H 'Content-Type: application/json' \
  -d '{
    "skuId": "string",
    "quantity": 1,
    "envRemark": "string",
    "automaticGeo": true,
    "automaticLanguage": true,
    "automaticLocation": true,
    "country": "string",
    "timezone": "string",
    "language": "string",
    "altitude": 0,
    "latitude": 0,
    "longitude": 0,
    "phoneNumber": "string",
    "brand": "string",
    "modelId": 0,
    "proxyId": 0,
    "tags": [
      "string"
    ],
    "groupId": 0,
    "groupName": "string"
  }'

Responses

成功

Bodyapplication/json
codeintegerrequired
msgstring or nullrequired
dataArray of strings

这是云手机IDS

requestIdstringrequired
errorobject
Response
{
  "code": 0,
  "msg": "string",
  "data": [
    "string"
  ],
  "requestId": "string",
  "error": {}
}