购买并激活包月云手机

API 参考

购买并激活包月云手机

Request

购买并激活 1 至 10 台包月云手机，使用期为 30 天。

扣费提醒：该操作会真实扣除团队余额。
权限：调用成员必须具有费用/支付管理权限，否则返回 99012。
先创建：请先通过 /api/cloudphone/create 创建云手机。创建仅生成未激活记录，不会扣费。
选择规则：ID 必须互不重复、属于当前团队，使用有效的 30 天包月商品，并具有兼容的购买状态。允许一次购买不同的包月 SKU。混合已支付与未支付手机、来自不同已支付订单的手机、存在待处理客户端订单或并发购买时，整个请求都会被拒绝。
扣费与恢复：校验和扣费为全有或全无，不会发生部分扣费。如果所有手机都属于同一个已支付订单，服务端会恢复已有权益，不会重复扣费。Local API、Open API 与桌面客户端共享同一订单状态。
完成信号：成功表示全部手机已确认激活 30 天；不会自动开机，也不会开启自动续费。
未确认激活：返回 33422 时，data.results 仍然完整并保持请求顺序。请逐项检查 status、expireTime 和 errorCode，不要把整个结果视为缺失。
重试：没有调用方幂等键。超时后先通过 /api/cloudphone/info 或 /api/cloudphone/page 检查计费与到期状态，再决定是否重试。
客户端版本：需要 MoreLogin 桌面客户端 v2.65.0 或更高版本；旧版本客户端不提供此 Local API 路由。

已记录的业务错误码：20002、20003、20004、20008、20041、20055、20068、20070、20071、33420、33421、33422、99001、99002、99012。各错误码含义见 Error Codes；接口还可能返回通用错误码。

客户端版本：需要 MoreLogin 桌面客户端 v2.65.0 或更高版本；旧版本客户端不提供此 Local API 路由。

Bodyapplication/jsonrequired

idsArray of strings, [ 1 .. 10 ] items, uniquerequired

One to ten distinct positive Cloud Phone IDs, encoded as strings to preserve 64-bit precision

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/monthly/activate \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "1724032706822188",
      "1724032729890861"
    ]
  }'

Responses

Request processed; inspect code, and inspect data.results when returned

Bodyapplication/json

codeintegerrequired

Business result code; 0 indicates success

Example:0

msgstring or nullrequired

Error message; null when successful

Example:null

requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"

dataobject(MonthlyCloudPhoneActivationData)

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "orderId": "1724032801202461",
    "orderStatus": 1,
    "results": [ … ]
  },
  "requestId": "db5e04c2eb804cdfb96b1469c7379bbc"
}