Tạo liên kết kết nối từ xa cho điện thoại đám mây

Tài liệu tham khảo API

Tạo liên kết kết nối từ xa cho điện thoại đám mây

Request

Tạo liên kết truy cập trình duyệt tạm thời cho điện thoại đám mây (chỉ Open API).

Điều kiện: điện thoại phải thuộc nhóm, thành viên gọi có quyền truy cập, đã bật và không bị thành viên khác chiếm dụng. API không tự bật điện thoại.
Tác động: mỗi lần gọi tạo liên kết mới, không yêu cầu thông tin xác thực kết nối hay thay đổi kết nối hiện tại. Mở data.url trong trình duyệt hoặc tạo mã QR từ toàn bộ URL.
Hiệu lực: cố định 5 phút từ lúc tạo. Truy cập lại không tiêu thụ hay gia hạn liên kết. Hết hạn thì gọi lại API. Không trả về expiredTime; thời hạn này không phải thời hạn thông tin xác thực kết nối.
Kết nối: mỗi lần truy cập thành công yêu cầu thông tin xác thực mới rồi chuyển hướng tới trang điều khiển từ xa, có thể ảnh hưởng kết nối trước đó. Có thể thử lại khi truy cập thất bại trong thời gian còn hiệu lực. Tạo liên kết thành công không đảm bảo kết nối sau đó thành công.
Bảo quản: giữ bí mật toàn bộ URL. Phản hồi có Cache-Control: no-store. Dùng nguyên URL trả về; máy chủ chọn tên miền và tham số kết nối.

Các mã lỗi nghiệp vụ đã ghi nhận: 33300, 33301, 99002. 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

idstringrequired

ID điện thoại đám mây MoreLogin.

langstring

Ngôn ngữ trang, ví dụ zh-CN hoặc en-US. Nếu bỏ qua hoặc để trống, dùng ngôn ngữ yêu cầu; giá trị không được hỗ trợ dùng mặc định cấu hình. Ngôn ngữ được ghi vào URL; có thể sửa tham số truy vấn lang để đổi ngôn ngữ trang.

curl -i -X POST \
  https://api.morelogin.com/cloudphone/link \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1710784536928649",
    "lang": "en-US"
  }'

Responses

Thành công. data.url là liên kết truy cập trình duyệt tạm thời, có hiệu lực 5 phút.

Headers

Cache-Controlstring

Không lưu phản hồi này vào bộ nhớ đệm.

Value:"no-store"

Bodyapplication/json

codeintegerrequired

Example:0

msgstring or nullrequired

Example:null

dataobjectrequired

requestIdstring

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "url": "https://gateway.example.com/app/cloudphone/qrcodeUrl?token=0123456789abcdef0123456789abcdef&lang=en-US"
  },
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}