Air724UG Panel - API 说明

概述

设备与面板之间的通信接口说明

Air724UG Panel 提供了完整的设备管理API，支持设备状态上报、命令下发、短信管理等功能。

主要包含两类接口：设备上报接口和设备拉取接口。

设备 → 面板（上报）

设备向面板发送状态、事件等信息

POST /event

设备事件上报接口，支持批量上报多个事件

请求示例

POST /event
Content-Type: application/json

{
  "device": "device001",
  "events": [
    {
      "type": "sms_incoming",
      "payload": {
        "from": "10086",
        "content": "您的流量余额为100MB"
      },
      "ts": 1690000000
    },
    {
      "type": "device_status",
      "payload": {
        "online": true,
        "csq": 25,
        "imei": "123456789012345"
      },
      "ts": 1690000000
    }
  ]
}

支持的事件类型

sms_incoming - 接收到的短信
device_status - 设备状态信息
config_data - 配置数据回执
command_result - 命令执行结果

设备 ← 面板（拉取）

设备从面板拉取待执行的命令

GET /pull?device={device}&since={id}

设备拉取命令接口，支持增量拉取

请求示例

GET /pull?device=device001&since=0

响应示例

[
  {
    "id": 1,
    "type": "sms_send",
    "payload": {
      "to": "10086",
      "content": "CXLL"
    },
    "ts": 1690000000
  },
  {
    "id": 2,
    "type": "config_get",
    "payload": {
      "keys": ["apn", "username", "password"]
    },
    "ts": 1690000000
  }
]

支持的命令类型

sms_send - 发送短信
config_get - 获取配置
config_set - 设置配置
device_status - 获取设备状态
inbox_get - 获取收件箱

控制台接口

管理员使用的控制台接口

POST /cmd - 泛型命令接口
POST /sms/send - 下发短信
POST /config/get - 获取设备配置
POST /config/set - 设置设备配置
GET /events - 查询事件记录
GET /commands - 查询命令记录
GET /sms/inbox - 查询收件箱
GET /device/status - 查询设备状态

鉴权说明

• 浏览器访问：使用会话Cookie进行认证

• 脚本/设备调用：可使用请求头 Authorization: Bearer {PANEL_AUTH}（可选）

• API说明页面：无需认证，可直接访问