listCharacterStickers
某个 catalog 角色的全部表情
主车道。最新在前,只含已发布的表情包。空页与 404 含义不同:角色没有素材时这里返回空列表,绝不会仅因为这个 id 就 404。
get
/v2/sticker/characters/{character_id}/stickersAuthorization: Bearer nmk_live_…(任意有效 v2 应用密钥即可,无需任何 scope)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
character_id 必填 | string | path | infra catalog 角色 id。 |
limit | integer | query | 每页条数,1-100,默认 20。超过 100 是 400 `LIMIT_TOO_LARGE`,不会被截断。 |
cursor | string | query | 同一个集合上一页返回的 `next_cursor`。不透明串;凡不是本面签发的都是 400 `INVALID_CURSOR`。 |
include_total | string | query | `true` 时附带 `total`,按与 `items` 相同的过滤条件计数。 truefalse |
响应
objectstring必填itemsobject[]必填objectstring必填idstringuuid 必填pack_idstringuuid 必填positioninteger必填从 1 开始,在同一个表情包内唯一。
imageobject必填notestringworkobjectcharacterobject
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>"