listCharacters
该站有表情素材的 catalog 角色
供调用方同步的索引:每个在已发布表情包中至少有一张表情的 catalog 角色 id,按数量排序。catalog 认识但该站没有素材的角色,按设计不会出现。
get
/v2/sticker/charactersAuthorization: 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 |
q | string | query | 不分大小写的子串匹配,同时跨全部语言——一个日文查询能命中只有日文标题匹配的表情包。超过 100 字符会被截断。 |
work | string | query | 收窄到某一部 catalog 作品的角色。 |
响应
objectstring必填itemsobject[]必填objectstring必填idstring必填infra catalog 角色 id。拿它去 `/v2/catalog/characters/{id}` 解析。
namemap<string, string>必填语言键到文本的映射。每个键都是可选的,任何一个都可能缺席;`und` 放的是 catalog 里没有语言标记的名字。
image_urlstringuricatalog 的立绘,通常是半身裁切而不是方图。catalog 标记该图为限制级时不下发。
sticker_countintegerint64workobject该站把这个角色关联到的游戏。
next_cursorstring取下一页时作为 `cursor` 传回。末页直接不出现这个键,而不是 null。
totalintegerint64满足过滤条件的总行数,跨全部分页。仅在 `include_total=true` 时出现。
请求示例
cURL
curl "https://api.nextmoe.dev/v2/sticker/characters" \
-H "Authorization: Bearer nmk_live_<YOUR_KEY>"