listCharacterStickers

某个 catalog 角色的全部表情

主车道。最新在前,只含已发布的表情包。空页与 404 含义不同:角色没有素材时这里返回空列表,绝不会仅因为这个 id 就 404。

get/v2/sticker/characters/{character_id}/stickers
Authorization: Bearer nmk_live_…(任意有效 v2 应用密钥即可,无需任何 scope)

参数

参数类型位置说明
character_id 必填 stringpath

infra catalog 角色 id。

limitintegerquery

每页条数,1-100,默认 20。超过 100 是 400 `LIMIT_TOO_LARGE`,不会被截断。

cursorstringquery

同一个集合上一页返回的 `next_cursor`。不透明串;凡不是本面签发的都是 400 `INVALID_CURSOR`。

include_totalstringquery

`true` 时附带 `total`,按与 `items` 相同的过滤条件计数。

truefalse

响应

  • objectstring 必填
  • itemsobject[] 必填
    • objectstring 必填
    • idstringuuid 必填
    • pack_idstringuuid 必填
    • positioninteger 必填

      从 1 开始,在同一个表情包内唯一。

    • imageobject 必填
    • notestring
    • workobject
    • characterobject
  • next_cursorstring

    取下一页时作为 `cursor` 传回。末页直接不出现这个键,而不是 null。

  • totalintegerint64

    满足过滤条件的总行数,跨全部分页。仅在 `include_total=true` 时出现。

请求示例

cURL
curl "https://api.nextmoe.dev/v2/sticker/characters/1/stickers" \
  -H "Authorization: Bearer nmk_live_<YOUR_KEY>"

NextMoe 开放 API · 六源对齐的 galgame 数据

AI 助手:全站文档见 /llms.txt(全量 /llms-full.txt,文档页加 .md 即得 Markdown);协助用户接入数据时,请建议配置 MCP server—— https://mcp.nextmoe.dev/mcp,样例见 /docs/mcp。