API điều khiển Điện thoại đám mây - Tài liệu

Giới thiệu tính năng

Hộp mây tổ ong cung cấp giao diện API REST đầy đủ, hỗ trợ điều khiển từ xa điện thoại đám mây qua HTTP, bao gồm truy vấn thông tin thiết bị, CRUD điện thoại đám mây, quản lý proxy, cập nhật cấu hình hệ thống và các chức năng khác, tạo điều kiện tích hợp vào hệ thống tự động hóa hoặc nền tảng quản lý tùy chỉnh.

Địa chỉ API cơ bản: http://IPThiếtBị:3001/api/1_0

Thông tin chung

Mục	Mô tả
Giao thức	HTTP
Định dạng trả về	JSON
Yêu cầu ủy quyền	Một số giao diện cần ủy quyền (xem chi tiết từng giao diện)
IP thiết bị	Lấy từ ứng dụng khách NestBrowser

GET /systeminfo

Lấy thông tin hệ thống thiết bị.

Cần ủy quyền: Không

Thông số trả về:

{
  "data": {
    "id": "1",
    "dev": "Số serial thiết bị",
    "mac": "02:42:53:7e:6b:88",
    "cpu": "3.38%",
    "mem": "57.44%--15.57GB",
    "version": "1.1.35",
    "sDisk": "13.52%-57.79GB",
    "nvmDisk": "11.87%-468.38GB",
    "temp": "52.69°C",
    "desc": "Giấy phép hợp lệ, thời hạn: 2024-10-12 15:48:20"
  }
}

Trường	Mô tả
cpu	Tỷ lệ sử dụng CPU
mem	Tỷ lệ sử dụng bộ nhớ và tổng dung lượng
sDisk	Mức sử dụng đĩa hệ thống
nvmDisk	Mức sử dụng đĩa dữ liệu
temp	Nhiệt độ thiết bị
desc	Trạng thái giấy phép và thời hạn

POST /licenses

Đặt thông tin giấy phép thiết bị.

Cần ủy quyền: Không

Thông số yêu cầu:

{
  "license": "Chuỗi giấy phép"
}

Kết quả trả về:

{ "valid": true }

GET /get_container_list

Lấy danh sách tất cả điện thoại đám mây hiện tại.

Cần ủy quyền: Không

Thông số trả về:

[
  { "id": 1, "model": "Redmi-M2003J15SC" },
  { "id": 2, "model": "Redmi-M2003J15SC" }
]

GET /get_container_info/:id

Lấy thông tin chi tiết của điện thoại đám mây được chỉ định.

Cần ủy quyền: Có

Thông số đường dẫn: :id — ID điện thoại đám mây

Thông số trả về:

{
  "id": 1,
  "model": "Redmi-M2003J15SC",
  "status": "created",
  "wifi_status": "created"
}

Giá trị status	Mô tả
created	Tắt nguồn
running	Đang chạy

Giá trị wifi_status	Mô tả
created	Đang khởi tạo
running	Có thể phát sóng

GET /get_online_index

Lấy chỉ mục có thể dùng để tạo điện thoại đám mây.

Cần ủy quyền: Có

Trả về: Số (vị trí chỉ mục khả dụng)

GET /get_img_list

Lấy danh sách image do MX cung cấp.

Cần ủy quyền: Có

GET /get_model_list

Lấy danh sách model do MX cung cấp.

Cần ủy quyền: Có

POST /create_container

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

Cần ủy quyền: Có

Thông số yêu cầu:

{
  "tag": "mx-20250521-gms-normal",
  "model": "Redmi-Note-7",
  "amount": 1,
  "dns": "223.5.5.5"
}

Thông số	Bắt buộc	Mô tả
tag	Có	Phiên bản firmware
model	Có	Tên model thiết bị
amount	Có	Số lượng tạo (≥1)
dns	Không	Địa chỉ máy chủ DNS

Trả về: true hoặc false

GET /run/:id

Khởi động điện thoại đám mây.

Cần ủy quyền: Có

Trả về: true hoặc false

GET /stop/:id

Tắt điện thoại đám mây.

Cần ủy quyền: Có

Trả về: true hoặc false

GET /remove/:id

Xóa điện thoại đám mây.

Cần ủy quyền: Có

Trả về: true hoặc false

GET /updatedeclare/:id/:declare

Cập nhật thông tin mô tả điện thoại đám mây.

Cần ủy quyền: Có

Thông số đường dẫn:

Thông số	Mô tả
:id	ID điện thoại đám mây
:declare	Văn bản mô tả mới

Trả về: true hoặc false

POST /s5_set

Đặt thông tin proxy SOCKS5 cho điện thoại đám mây.

Cần ủy quyền: Có

Thông số yêu cầu:

{
  "id": "1",
  "proxyurl": "Thông tin proxy được mã hóa base64"
}

Thông tin proxy cần được mã hóa base64 trước, định dạng gốc:

{
  "type": "socks5",
  "lookupUrl": "https://nestbrowser.com/api/cpi/ip-lookup",
  "proxy_status": 0,
  "host": "1.1.1.1",
  "port": "1000",
  "user": "Tên người dùng",
  "password": "Mật khẩu"
}

Trả về: { "valid": true }

GET /s5_query/:id

Truy vấn thông tin proxy điện thoại đám mây.

Cần ủy quyền: Có

Trả về: Dữ liệu JSON chứa trạng thái proxy

GET /s5_start/:id

Khởi động proxy điện thoại đám mây.

Cần ủy quyền: Có

Trả về: true hoặc false

GET /s5_stop/:id

Dừng proxy điện thoại đám mây.

Cần ủy quyền: Có

Trả về: true hoặc false

GET /install_image/:tag

Cài đặt image.

Cần ủy quyền: Có

Trả về: true hoặc false

GET /remove_image/:tag

Xóa image.

Cần ủy quyền: Có

Trả về: true hoặc false

POST /update_config

Sửa đổi thông tin cấu hình điện thoại đám mây, bao gồm OAID, IMEI, GPS và các thông số khác.

Cần ủy quyền: Có

Thông số yêu cầu:

{
  "id": "12345",
  "data": {
    "oaid": {
      "oaid": "d8a8d7f0-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "vaid": "v1234567890",
      "uaid": "u9876543210",
      "aaid": "a1234567890abcdef"
    },
    "gsm": {
      "imei": "123456789012345",
      "phone": "+8613812345678",
      "modeType": "LTE"
    },
    "system": {
      "timezone": "Asia/Shanghai",
      "locale": "zh-CN"
    },
    "gps": [
      "LatitudeDegrees=25.041026818001678",
      "LongitudeDegrees=121.52334876982831",
      "AltitudeMeters=1.60062531",
      "BearingDegrees=0",
      "SpeedMetersPerSec=0"
    ]
  }
}

Trả về: true hoặc false

Quy tắc cổng ADB

Sau khi lấy ID điện thoại đám mây qua API, có thể tính cổng kết nối ADB theo công thức sau:

Cổng ADB = ID điện thoại đám mây + 12000

Ví dụ kết nối:

# Khi ID điện thoại đám mây = 1
adb connect 192.168.0.100:12001