Emoji API
OwO 格式的表情数据接口,兼容 Twikoo、Artalk、Waline 等评论系统的自定义表情包配置(参考 owo.imaegoo.com/owo.json)。
接口说明
| 接口 | 说明 |
|---|---|
/emoji/owo.json |
返回全部表情分组 |
/emoji |
同上(别名) |
/emoji/owo.json?group=Bilibili |
只返回指定分组 |
请求示例:/emoji/owo.json、/emoji/owo.json?group=Emoji
当前内置分组:颜文字、Emoji、Bilibili、QQ、小黑盒、小红书。
返回格式
顶层为「分组名」,type 为表情类型,container 为该分组下的表情列表:
{
"颜文字": {
"type": "emoticon",
"container": [
{ "icon": "OωO", "text": "Author: DIYgod" },
{ "icon": "(☆ω☆)", "text": "星星眼" }
]
},
"Emoji": {
"type": "emoji",
"container": [
{ "icon": "😀", "text": "开心" }
]
},
"Bilibili": {
"type": "image",
"container": [
{ "icon": "<img src=\"https://api.example.com/static/emoji/bilibili/6ea59c827c414b4a2955fe79e0f6fd3dcd515e24.png\">", "text": "doge" }
]
}
}
type
emoticon:颜文字,icon直接是文本emoji:Emoji 字符,icon直接是字符image:图片表情,icon为<img src="...">标签,其中src是本服务的完整图片地址
group
- 可选参数,按分组名精确匹配(需要 URL 编码,如
?group=%E9%A2%9C%E6%96%87%E5%AD%97) - 分组不存在时返回
404,并在响应中给出全部分组名
升级与自定义
表情数据首先生成到 data/config/emoji.json,之后以该文件为准:
- 新版本内置了新的表情分组(例如从 0.2.1 起新增的「小红书」)时,读取数据会自动把缺失的分组补进配置文件,日志会打印
Merged new emoji groups from built-in data: ...,无需手工合并 - 只会补充「配置文件里没有的分组」,不会覆盖已有分组,也不会改动你删减过的表情项
- 想彻底隐藏某个分组:保留该分组、把
container置为空数组[],空分组不会被当成缺失而补回;想恢复时删掉这一项或把内容补回即可 - 想从零重建:删除
data/config/emoji.json,重启后会用内置默认数据重新生成(会覆盖后台的手工修改)
Made with ❤️ by Motues
如果使用过程中存在问题,欢迎通过邮件告诉我