LG 开放平台接口文档

服务地址

LG 开放平台服务，接口路径均以服务前缀拼接：

接口调用一览表

合计：16 个接口，每个接口独立一页，详见左侧目录或下方分组。

统一请求约定

3.1 请求头

接口鉴权通过请求头 Authorization 携带 API Key。所有接口涉及的请求头如下：

请求示例（curl）：

# 查询上架列表
curl -X GET "https://lg.jimitu.top/api/open/publishings" \
  -H "Authorization: Bearer <your_api_key>"

3.2 设备绑定流程（channel_id 说明）

绑定设备时，渠道 ID（channel_id）由平台根据设备码自动匹配，调用方无需手动指定或预先查询。完整流程分两步：

1. 设备 → 渠道：提交设备码后，平台通过 GET /api/open/devices/character?device_id=<设备码> 反查该设备归属的渠道，得到 channel_id
2. 发起绑定：用查到的 channel_id 调用 POST /api/open/channels/{channel_id}/bind-device 完成绑定

说明：

• 调用方只需提交有效的设备码，渠道匹配由平台处理，无需维护 channel_id
• GET /api/open/channels 返回的是「当前 API Key 关联的全部上架渠道清单」，不用于指定某设备属于哪个渠道；绑定使用的是 devices/character 反查到的渠道
• 解绑（DELETE .../bind-device）同理，channel_id 可从绑定结果或设备列表中获得

3.3 统一响应格式

标准 ApiResponse<T>：

{
  "success": true,
  "data": T,
  "message": "（失败时）错误说明",
  "error_code": "（失败时）错误码",
  "pagination": { /* 分页响应时附带 */ }
}

分页响应（保留完整对象，含 pagination）：

{
  "data": [ ... ],
  "pagination": {
    "current_page": 1,
    "total_pages": 3,
    "total_count": 58,
    "has_next": true,
    "has_previous": false
  }
}

响应解包规则：

• success: true 且无 pagination → 取 data 字段
• success: true 且有 pagination → 返回完整对象（含 pagination）
• success: false → 业务错误，含 message 与 error_code
• 无 success 字段 → 直接返回 body 或 body.data

3.4 错误处理

所有接口的错误响应遵循统一格式：{ "success": false, "message": "...", "error_code": "..." }。

error_code 枚举（通用）：