Tạo điện thoại đám mây

Tài liệu tham khảo API

Request

Mua và cấp phát một hoặc nhiều cloud phone.

Điều kiện tiên quyết: gói phải còn dung lượng và hạn mức tạo trong ngày chưa được dùng hết. country, timezone và language được kiểm tra theo danh sách mà dịch vụ thiết bị đã chọn hỗ trợ, nên một tổ hợp không được hỗ trợ sẽ bị từ chối chứ không bị âm thầm điều chỉnh. Tọa độ bị giới hạn trong ±180 kinh độ và ±90 vĩ độ. Số điện thoại bị bỏ qua khi SKU đã chọn không hỗ trợ. Có thể tạo SKU theo tháng qua API khi sản phẩm được /cloudphone/monthly/skus trả về; kỳ hiện tại là 30 ngày.
Tác động: tạo các bản ghi cloud phone. SKU tính theo phút dùng được sau khi cấp phát; SKU theo tháng được tạo ở trạng thái chưa kích hoạt. Bước tạo không thu phí; Cloud Phone theo tháng chỉ bị tính phí khi gọi /cloudphone/monthly/activate, còn loại theo phút bắt đầu dùng số dư hoặc hạn mức khi bật nguồn.
Hoàn tất: đã tiếp nhận, chưa hoàn tất. Máy ảo phía dịch vụ thiết bị chưa sẵn sàng, và bật quá sớm sẽ bị từ chối. Hãy hỏi vòng /cloudphone/info hoặc /cloudphone/page cho đến khi envStatus báo máy đã tắt. Với SKU theo tháng, cũng phải hoàn tất /cloudphone/monthly/activate trước khi bật nguồn.
Thử lại: không idempotent và không được xếp tuần tự. Không có khóa idempotency. Đừng thử lại một cách mù quáng sau khi hết thời gian chờ: hãy truy vấn trạng thái trước.

Các mã lỗi nghiệp vụ đã ghi nhận: 19064, 20018, 33338, 33339, 33340, 33341, 33342, 33343, 33344, 33345, 33398, 33399, 33400, 33408. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Security

Authorization

Bodyapplication/jsonrequired

skuIdstringrequired

Dòng máy cloud phone

Dòng máy cloud phone	SKU ID (`skuId`)
Android 12	`10002`
Android 13	`10013`
Android 14	`10005`
Android 15	`10004`
Android 15A	`10014`
Android 16	`10015`
Android 17	`10105`

Xem bảng quốc gia và múi giờ để biết các khu vực được hỗ trợ và cách đối chiếu múi giờ

quantityinteger, [ 1 .. 10 ]required

Số lượng cloud phone được tạo. Phạm vi giá trị: [1-10]

envRemarkstring, <= 1500 characters

Ghi chú của profile (giới hạn 1500 ký tự)

groupIdstring

ID nhóm. Dùng "0" cho trường hợp chưa thuộc nhóm nào.

groupNamestring, <= 50 characters

Tên một nhóm đã có, hoặc tên nhóm mới sẽ được tạo khi không có nhóm nào khớp.

automaticGeoboolean

Có tự động khớp vị trí địa lý hay không. Mặc định: true

automaticLanguageboolean

Có tự động khớp ngôn ngữ hay không. Mặc định: true

automaticLocationboolean

Có tự động khớp vị trí (múi giờ, quốc gia) hay không. Mặc định: true

countrystring

Mã quốc gia (ví dụ us). Xem bảng quốc gia và múi giờ để biết danh sách đầy đủ

timezonestring

Múi giờ, ví dụ America/New_York

languagestring

Ngôn ngữ, ví dụ en-US

altitudenumber

Độ cao

latitudenumber

Vĩ độ. Ví dụ: 22.309182

longitudenumber

Kinh độ. Ví dụ: 114.176817

speednumber, <= 400

Tốc độ di chuyển

bearingnumber, <= 360

Hướng di chuyển

accuracynumber, <= 100

Độ chính xác theo phương ngang

phoneNumberstring

Số điện thoại tùy chỉnh. Yêu cầu về định dạng: phải bắt đầu bằng dấu +, mã quốc gia phải có 1-3 chữ số (không bao gồm 86), tổng độ dài 8-14 chữ số, và chỉ được chứa dấu + cùng các chữ số.

brandstring

Thương hiệu thiết bị. Bạn có thể tra cứu qua giao diện https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

modelIdnumber

ID dòng máy thiết bị. Bạn có thể tra cứu qua giao diện https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

proxyIdstring

ID proxy

tagsArray of strings

Tên các thẻ. Giá trị rỗng sẽ bị bỏ qua.

curl -i -X POST \
  https://api.morelogin.com/cloudphone/create \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "skuId": "1661515884160372",
    "quantity": 1
  }'

Responses

Bodyapplication/json

codeintegerrequired

msgstring or nullrequired

dataArray of strings

Đây là hệ thống xác thực danh tính điện thoại đám mây (Cloud phone IDS).

requestIdstringrequired

errorobject

Response

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