fetch_sys_faces

fetch_sys_faces只读系统表情
获取 QQ 系统表情目录

Call via POST http://127.0.0.1:3000/fetch_sys_faces (JSON params as the body) or WebSocket.

Parameters

Param Type Required Default Description
refresh bool false 是否强制从 QQ 刷新目录

Returns (data)

按分组返回完整的 QQ 系统表情映射。

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

Field Type Required Description
packs object[]
Raw JSON Schema
{
  "type": "object",
  "properties": {
    "packs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "pack_name": {
            "type": "string"
          },
          "emojis": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "q_sid": {
                  "type": "string",
                  "description": "QQ 表情目录标识(部分 emoji 为 Unicode 表情字符串)"
                },
                "q_des": {
                  "type": "string",
                  "description": "表情描述"
                },
                "em_code": {
                  "type": "string"
                },
                "q_cid": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "ani_sticker_type": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "ani_sticker_pack_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "ani_sticker_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "emoji_name_alias": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "ani_sticker_width": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "ani_sticker_height": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "is_super": {
                  "type": "boolean",
                  "description": "是否使用超级表情格式"
                }
              },
              "required": [
                "q_sid",
                "q_des",
                "em_code",
                "q_cid",
                "ani_sticker_type",
                "ani_sticker_pack_id",
                "ani_sticker_id",
                "url",
                "emoji_name_alias",
                "ani_sticker_width",
                "ani_sticker_height",
                "is_super"
              ]
            }
          }
        },
        "required": [
          "pack_name",
          "emojis"
        ]
      }
    }
  },
  "required": [
    "packs"
  ]
}

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/fetch_sys_faces \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"refresh":false}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.