區域網路雲手機設備 API 文件 - 幫助文件

原文來源：語雀幫助文件

概述

蜂巢雲盒提供局域網 HTTP API，允許通過代碼對設備和雲手機實例進行管理與控制，適用於：

自動化運維腳本
與第三方系統集成
批量任務調度

API 版本：V1_0
接口基地址：http://<設備IP>:3001/api/1_0

構造請求

const HTTP = require('http');

const base_url = 'http://x.x.x.x:3001/api/1_0';

// 示例：獲取設備信息
const api = base_url + '/systeminfo';
HTTP.get(api, function(err, res) {
  // 處理響應
});

將 x.x.x.x 替換為雲盒設備在局域網中的實際 IP 地址。

接口列表

GET /systeminfo

功能：獲取設備基礎信息
是否需要授權：否

響應示例：

{
  "code": 0,
  "data": {
    "device_id": "nestbox-001",
    "model": "NestBox Pro",
    "android_version": "12",
    "cpu_usage": 23.5,
    "memory_total": 8192,
    "memory_used": 3421,
    "storage_total": 128000,
    "storage_used": 45320
  }
}

GET /get_container_list

功能：獲取當前所有雲手機實例列表
是否需要授權：否

響應示例：

{
  "code": 0,
  "data": [
    {
      "id": "container-001",
      "name": "雲手機01",
      "status": "running",
      "ip": "172.16.0.101",
      "port": 5555,
      "created_at": "2025-04-01T10:00:00Z"
    }
  ]
}

POST /start_container

功能：啟動指定雲手機實例
是否需要授權：是（需傳入 token）

請求參數：

參數	類型	必填	說明
`container_id`	string	是	實例 ID
`token`	string	是	管理員認證 token

請求示例：

const options = {
  hostname: 'x.x.x.x',
  port: 3001,
  path: '/api/1_0/start_container',
  method: 'POST',
  headers: { 'Content-Type': 'application/json' }
};

const body = JSON.stringify({
  container_id: 'container-001',
  token: 'your-admin-token'
});

POST /stop_container

功能：停止指定雲手機實例
參數：同 /start_container

GET /container_info

功能：獲取單個實例詳細信息
參數：

參數	類型	必填	說明
`container_id`	string	是	實例 ID

錯誤碼說明

code	含義
`0`	成功
`401`	未授權（缺少 token）
`404`	實例不存在
`500`	伺服器內部錯誤

概述