fetch_custom_face_detail

fetch_custom_face_detail只读扩展
获取自定义表情详情

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

Parameters

Param Type Required Default Description
count int 48

Returns (data)

自定义表情详情数组,包含资源标识、图片地址、摘要与描述。

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

data is an array; each element:

Field Type Required Description
emoji_id string 可传给 SnowLuma 表情管理接口的资源标识
resId string 兼容 NapCat 的资源标识
url string 表情图片地址
md5 string 表情内容摘要
desc string 自定义表情描述;未设置时为空字符串
Raw JSON Schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "emoji_id": {
        "type": "string",
        "description": "可传给 SnowLuma 表情管理接口的资源标识"
      },
      "resId": {
        "type": "string",
        "description": "兼容 NapCat 的资源标识"
      },
      "url": {
        "type": "string",
        "description": "表情图片地址"
      },
      "md5": {
        "type": "string",
        "description": "表情内容摘要"
      },
      "desc": {
        "type": "string",
        "description": "自定义表情描述;未设置时为空字符串"
      }
    },
    "required": [
      "emoji_id",
      "resId",
      "url",
      "md5",
      "desc"
    ]
  }
}

Examples

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

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