Skip to content
Tài liệu tham khảo API
/
/
/
Mua và kích hoạt Cloud Ph...

Mua và kích hoạt Cloud Phone theo tháng

Request

Mua và kích hoạt từ 1 đến 10 Cloud Phone theo tháng trong 30 ngày.

  • Cảnh báo tính phí: thao tác này thực sự trừ số dư của nhóm.
  • Quyền: thành viên phải có quyền Quản lý chi phí/thanh toán, nếu không sẽ trả 99012.
  • Tạo trước: dùng /api/cloudphone/create; bước tạo chỉ sinh bản ghi chưa kích hoạt và không tính phí.
  • Quy tắc chọn: ID phải khác nhau, thuộc nhóm và dùng sản phẩm 30 ngày còn hiệu lực. Có thể trộn các SKU theo tháng. Trạng thái hoặc đơn hàng không tương thích, đơn đang chờ từ ứng dụng và mua đồng thời sẽ từ chối toàn bộ yêu cầu.
  • Tính phí và khôi phục: xác thực và tính phí là toàn bộ hoặc không gì cả. Nếu cùng một đơn đã thanh toán, hệ thống khôi phục quyền hiện có và không thu lại. Local API, Open API và ứng dụng dùng chung trạng thái đơn.
  • Hoàn tất: xác nhận 30 ngày cho tất cả; không bật máy và không bật tự động gia hạn.
  • Chưa xác nhận kích hoạt: với 33422, data.results vẫn đầy đủ và đúng thứ tự. Kiểm tra status, expireTime, errorCode.
  • Thử lại: sau timeout, truy vấn /api/cloudphone/info hoặc /api/cloudphone/page.

Lỗi đã ghi nhận: 20002, 20003, 20004, 20008, 20041, 20055, 20068, 20070, 20071, 33420, 33421, 33422, 99001, 99002, 99012. Xem Error Codes.

  • Phiên bản ứng dụng: cần MoreLogin Desktop v2.65.0 trở lên; phiên bản cũ không cung cấp tuyến Local API này.
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"
}