GET /api/open/publishings — 获取上架列表

获取上架列表

更新时间：2026/08/18

获取上架列表，含 template_id 与 hardware_channels。设备绑定时需要 template_id 创建角色实例，channel_id 用于绑定路径。

🔧请求信息

请求 URI

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

请求头参数

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

请求参数

无

请求示例

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

📥响应信息

响应体示例

{
  "success": true,
  "data": [
    {
      "id": 1,
      "template_id": 10,
      "template_name": "默认模版",
      "publish_name": "chirpy 初代",
      "publish_logo": "https://...",
      "interaction_name": "自由对话",
      "publish_game_url": "https://...",
      "template_info": {
        "description": "...",
        "basic_personality": "...",
        "gender": "female",
        "catchphrase": "...",
        "background": "...",
        "creator_name": "官方",
        "source": "官方"
      },
      "hardware_channels": [
        {
          "channel_id": 100,
          "channel_type": "official_hardware",
          "channel_type_display": "官方硬件",
          "hardware_type": "AI玩偶",
          "status": "online"
        }
      ],
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ]
}

响应参数

字段	类型	说明
id	integer	上架 ID（TemplatePublishing.id）
template_id	integer	模版 ID，创建角色实例时使用
template_name	string	模版名称
publish_name	string	上架显示名
publish_logo	string	上架图标 URL
interaction_name	string	交互名称
publish_game_url	string	游戏地址 URL
template_info	object	模版信息（描述/人设/性别/口头禅/背景等）
hardware_channels	array	硬件渠道数组，见下表
created_at	string	创建时间（ISO 8601）
updated_at	string	更新时间（ISO 8601）

⚠️错误码

错误码

error_code	HTTP	说明
—	401	API Key 无效或已过期
—	403	API Key 未关联该上架

📋其他

hardware_channels[] 字段

字段	类型	说明
channel_id	integer	渠道 ID（ChannelPublish.id），绑定设备路径必须使用
channel_type	string	渠道类型编码：`official_hardware` / `merchant_hardware`
channel_type_display	string	渠道类型中文名
hardware_type	string	硬件子类型（如 AI玩偶、AI眼镜）
status	string	渠道状态，上架为 `online`