局域网云手机设备 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`	服务器内部错误

概述