「Emoji 表情符号」是数据鱼API平台提供的表情符号检索与解析接口,Base 路径 /api/emoji,共 5 个端点。它把一枚表情符号与它的中文名、所属分组、关键词、Unicode 码位和 HTML 实体串成一条结构化记录,供调用方按关键词检索、按分类浏览,或对单个字符做解析。
接口要解决的问题很具体:表情符号在昵称、评论、商品标题里大量出现,但程序侧往往只拿到一个字符,既不知道它叫什么,也无法判断它属于哪一类,更不方便转成 HTML 实体或码位形式输出。emoji 接口把这层映射放在服务端完成,调用方一次请求就能从字符得到可读描述,或从关键词得到字符清单。
数据来源是服务端内置的结构化表情库,按 Unicode 标准整理,当前收录 606 条记录、划分为 8 个分组。检索为本地内存匹配,不依赖外部上游服务,因此响应稳定;相应地,可检索范围也严格受限于这份内置数据,库中未收录的字符不会被检索到。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/emoji/ping | 健康检查,返回版本与分类数量 | 否 |
GET | /api/emoji/search | 按关键词搜索表情 | 是 |
GET | /api/emoji/categories | 返回全部分类名称 | 是 |
GET | /api/emoji/group | 按分类名称取该分类下的表情 | 是 |
GET | /api/emoji/parse | 解析单个表情字符的完整信息 | 是 |
以上为数据鱼API平台的通用约定,本接口未对其做额外扩展。
在一个调用里完成关键词到表情清单的检索,匹配范围为中文名、关键词串与完整字符本身。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
q | string | 是 | — | 搜索词,可为中文、英文或一个完整表情字符;为空返回 4001 |
limit | int | 否 | 50 | 返回条数上限,达到上限即停止扫描 |
返回 data 为数组,元素字段包括:char 表情字符,name 中文名称,group 所属分组,keywords 关键词数组,codes 形如 U+1F600 的码位数组,html 十进制 HTML 实体。名称与关键词转为小写后做子串包含判断,字符做完全相等判断,因此英文关键词大小写不敏感,中文按原样匹配;结果按内置库顺序返回,不做相关度排序。
GET /api/emoji/search?q=开心&limit=10{"code":0,"msg":"success","data":[{"char":"😀","name":"咧嘴笑","group":"笑脸与情感","keywords":["grinning","smile","开心"],"codes":["U+1F600"],"html":"😀"}]}无参数,返回 8 个分类名称的字符串数组,顺序固定:笑脸与情感、手势与人、动物与自然、食物与饮料、活动与运动、旅行与地点、物品与工具、符号与标志。该端点通常作为 group 的前置调用,用于取得合法的分类名。
GET /api/emoji/categories按分类名取出该分类下的全部表情,适用于目录页、选择器一类需要整组展示的场景。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
name | string | 是 | — | 分类名称,需与 categories 返回的名称完全一致 |
返回 data 为数组,元素结构与 search 相同。分类名精确匹配,大小写与空格都参与比较;传入不存在的分类不会报错,而是返回空数组。这一点与 parse 的失败行为不同,调用方需自行区分分类为空与分类不存在。
GET /api/emoji/group?name=笑脸与情感给定一个表情字符,返回它在库中的唯一记录,常用于把用户输入或日志中的字符还原成可读信息。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
char | string | 是 | — | 一个完整表情字符,按原样精确匹配 |
命中时返回该记录对象,字段同 search 的元素;未命中返回 HTTP 404 与业务码 4004,msg 为「未找到该表情」。多字符组合(肤色修饰、零宽连接序列)只有在库中作为单条记录收录时才能命中。
GET /api/emoji/parse?char=😀原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。