创建云手机

API 参考

创建云手机

Request

购买并开通一台或多台云手机。

前置条件：套餐必须有剩余额度，且当日创建配额未用尽。country、timezone、language 会按所选机型支持的列表校验，不支持的组合会被拒绝而不是被静默调整。经度限 ±180、纬度限 ±90。所选 SKU 不支持手机号时，传入的手机号会被丢弃。包月 SKU 可通过 API 创建，但必须是 /api/cloudphone/monthly/skus 返回的商品；当前周期为 30 天。
副作用：创建云手机记录。按量计费的 SKU 完成开通后可用；包月 SKU 创建后处于未激活状态。创建操作本身不扣费；包月云手机仅在调用 /api/cloudphone/monthly/activate 时扣费，按量云手机则在开机后开始消耗余额或额度。
完成信号：已受理，未完成。 此时云手机实例尚未就绪，过早开机会被拒绝。请轮询 /api/cloudphone/info 或 /api/cloudphone/page 直到 envStatus 变为已关机。对于包月 SKU，还必须先完成 /api/cloudphone/monthly/activate 才能开机。
重试：不幂等，且没有串行化。没有幂等键。超时后不要盲目重试，先查询状态。

已记录的业务错误码：19064, 20018, 33338, 33339, 33340, 33341, 33342, 33343, 33344, 33345, 33398, 33399, 33400, 33408。各错误码的含义见 Error Codes。任何接口还可能返回通用错误码。

Bodyapplication/jsonrequired

skuIdstringrequired

云手机机型

云手机机型	SKU ID (`skuId`)
Android 12	`10002`
Android 13	`10013`
Android 14	`10005`
Android 15	`10004`
Android 15A	`10014`
Android 16	`10015`
Android 17	`10105`

支持的地区与时区映射见国家与时区对照表

quantityinteger, [ 1 .. 10 ]required

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

envRemarkstring, <= 1500 characters

备注（长度上限 1500 字符）

groupIdstring

分组 ID。未分组填 "0"。

groupNamestring, <= 50 characters

已有分组名称；若没有匹配的分组，则按该名称新建。

automaticGeoboolean

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

automaticLanguageboolean

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

automaticLocationboolean

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

countrystring

国家代码（例如 us）。完整清单见国家与时区对照表

timezonestring

时区，例如 America/New_York

languagestring

语言，例如 en-US

altitudenumber

海拔

latitudenumber

纬度。示例：22.309182

longitudenumber

经度。示例：114.176817

speednumber, <= 400

移动速度

bearingnumber, <= 360

移动方向

accuracynumber, <= 100

水平精度

phoneNumberstring

自定义手机号。格式要求：必须以 + 号开头，国家代码为 1-3 位数字（不含 86），总长度 8-14 位，且只能包含 + 与数字。

brandstring

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

modelIdnumber

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

proxyIdstring

代理 ID

tagsArray of strings

标签名称。空值会被忽略。

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/create \
  -H 'Content-Type: application/json' \
  -d '{
    "skuId": "1661515884160372",
    "quantity": 1
  }'

Responses

成功

Bodyapplication/json

codeintegerrequired

msgstring or nullrequired

dataArray of strings

这是云手机IDS

requestIdstringrequired

errorobject

Response

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