listPacks
列出已发布的表情包
/v2/sticker/packsAuthorization: Bearer nmk_live_…（任意有效 v2 应用密钥即可,无需任何 scope）参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
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 |
sort | string | query | `new`（默认）按发布时间排，`hot` 先按下载数再按浏览数。两者都以 id 收尾，而 id 是 UUIDv7，因此是稳定的 tiebreaker。 newhot |
q | string | query | 不分大小写的子串匹配，同时跨全部语言——一个日文查询能命中只有日文标题匹配的表情包。超过 100 字符会被截断。 |
nsfw | string | query | `true` 包含 r18 表情包；不传或 `false` 隐藏它们。含义与 catalog 的 nsfw 参数相同。注意这是**表情包自己**的分级：从 r18 游戏里剪出来的普通反应表情包是 `all_ages`，而它所属作品的 `content_rating` 仍然是 `r18`。 truefalse |
tag | string | query | 标签 slug。未知 slug 匹配不到任何东西，而不是报错。 |
work | string | query | catalog 作品 id。保留声明了这部游戏、或含有该游戏表情的表情包——与 `/v2/sticker/works/{work_id}/packs` 用的是同一条关系。 |
official | string | query | true 只保留由站方自己发布的表情包。 truefalse |
linked | string | query | true 只保留声明了 catalog 作品的表情包。 truefalse |
响应
objectstring必填itemsobject[]必填objectstring必填idstringuuid 必填titlemap<string, string>必填语言键到文本的映射。每个键都是可选的，任何一个都可能缺席；`und` 放的是 catalog 里没有语言标记的名字。
descriptionmap<string, string>必填语言键到文本的映射。每个键都是可选的，任何一个都可能缺席；`und` 放的是 catalog 里没有语言标记的名字。
officialboolean必填由站方自己发布，而不是由用户发布。
content_ratingstring必填表情包自己的分级，不是它所属游戏的分级。
枚举all_agesr18sticker_countinteger必填view_countintegerint64 必填download_countintegerint64 必填coverobject只是渲染时的便利字段。它不带 hash；要稳定身份请用 cover_sticker_id。
cover_sticker_idstringuuidworkobject表情包声明的游戏——前提是作者声明过。混合包不声明任何游戏，但每张表情上仍带各自的关联。
tagsobject[]必填authorobject必填created_atstringdate-time 必填updated_atstringdate-time 必填published_atstringdate-time
next_cursorstring取下一页时作为 `cursor` 传回。末页直接不出现这个键，而不是 null。
totalintegerint64满足过滤条件的总行数，跨全部分页。仅在 `include_total=true` 时出现。
请求示例
curl "https://api.nextmoe.dev/v2/sticker/packs" \
-H "Authorization: Bearer nmk_live_<YOUR_KEY>"