GET /api/open/channels — 获取硬件渠道列表

获取硬件渠道列表

更新时间：2026/08/18

仅返回已上架渠道。

🔧请求信息

请求 URI

GET https://lg.jimitu.top/api/open/channels

请求头参数

Header	必填	说明
`Authorization`	是	Bearer {API Key}，接口鉴权，所有请求均需携带
`Content-Type`	否	仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json

请求参数

无

请求示例

curl -X GET "https://lg.jimitu.top/api/open/channels" \
  -H "Authorization: Bearer <your_api_key>"

📥响应信息

响应体示例

{
  "success": true,
  "data": [
    {
      "channel_id": 100,
      "publish_name": "chirpy 初代",
      "channel_type": "official_hardware",
      "channel_type_display": "官方硬件",
      "hardware_type": "AI玩偶",
      "status": "online",
      "publishing_id": 1,
      "template_id": 10,
      "created_at": "...",
      "updated_at": "..."
    }
  ]
}

响应参数

字段	类型	说明
channel_id	integer	渠道 ID，绑定设备时使用
publish_name	string	上架名
channel_type	string	渠道类型编码
channel_type_display	string	渠道类型中文名
hardware_type	string	硬件子类型
status	string	渠道状态，固定为 `online`
publishing_id	integer	关联上架 ID
template_id	integer	关联模版 ID
created_at	string	创建时间
updated_at	string	更新时间

⚠️错误码

错误码

error_code	HTTP	说明
`CHANNEL_NOT_FOUND`	404	渠道不存在
`CHANNEL_OFFLINE`	400	渠道已下架

注意

绑定/查询设备前建议先确认渠道状态：渠道不存在时返回 CHANNEL_NOT_FOUND，渠道已下架时返回 CHANNEL_OFFLINE。