「特殊符号与颜文字库」是数据鱼API平台提供的符号素材检索与花式字体转换接口,Base 路径 /api/fuhao,共 7 个端点。它把聊天、网名、社交平台排版常用的装饰符号、分割线、箭头、序号、货币与天气符号,以及颜文字与花式字转换能力,整理成可按分类浏览、按关键词搜索、按数量随机抽取的 JSON 资源。
数据形态为服务端内置的静态符号表,不依赖外部字符库或字体服务。统计端点给出的规模是:12 个分类、653 个符号、135 条颜文字、16 种情绪分组,另有 10 种花式字风格。全部内容以字符本身加元数据的形式返回,包含字符、名称、标签、所属分类与分类中文名,调用方可以直接渲染,也可以按标签二次归类。
花式字部分按 Unicode 的数学字母数字、装饰符号等区块做显式映射,支持粗体、斜体、粗斜体、手写体、哥特体、双线体、圈号、全角、上标、下标十种风格。由于映射依赖具体码位,个别字符在部分字体或平台上可能显示为方框,统计端点在 note 字段中对此有明确提示。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/fuhao/ping | 健康检查,返回版本与服务器时间 | 免鉴权 |
GET | /api/fuhao/stats | 返回分类数、符号数、颜文字数、风格数与各项上限 | 需要 |
GET | /api/fuhao/categories | 返回全部分类、颜文字情绪分组与花式字风格清单 | 需要 |
GET | /api/fuhao/list | 按分类分页列出符号条目 | 需要 |
GET | /api/fuhao/search | 按关键词检索名称与标签 | 需要 |
GET | /api/fuhao/fancy | 把文本转换为一种或多种花式字 | 需要 |
GET | /api/fuhao/random | 在指定分类内随机抽取符号或颜文字 | 需要 |
鉴权使用数据鱼API平台统一 Key,请求头 X-API-Key 或查询参数 ?api_key= 均可,缺失返回 4011,无效返回 4013。响应体统一为 {code, msg, data},字符内容放在 data 内。错误码语义在本接口中区分得比较细:4001 表示缺少必填参数,如 list 少 cat、search 少 kw、fancy 少 text;4002 表示参数取值非法,包括关键词超长、文本超过 64 字符、分页或抽样数越界、花式风格不在支持列表;4004 表示分类 id 未收录,错误信息会附带提示去查阅分类端点。分页与抽样参数按严格整数解析,传小数或非数字一律返回 4002,不会静默取默认值。该接口无上游依赖,5031/5032 不适用。
一次取回三类元数据:分类列表(id、name、desc、count),颜文字按情绪的 moods 分组,以及 fancy_styles 风格表。分类 id 是后续 list 与 random 的入参,风格 id 是 fancy 的入参,建议客户端首次接入时缓存这份清单。
GET /api/fuhao/categories?api_key=YOUR_API_KEY按分类返回符号条目,带分页信息,适合做符号选择器或素材列表页。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
cat | string | 是 | - | 分类 id,取自 categories 端点 |
page | int | 否 | 1 | 页码,从 1 开始,上限 100000 |
page_size | int | 否 | 实现默认值 | 每页条数,超过上限返回 4002 |
api_key | string | 是 | - | 平台 Key |
GET /api/fuhao/list?cat=wangming&page=1&page_size=50&api_key=YOUR_API_KEY在符号名称与标签中做子串检索,单次最多返回 80 条;命中超过上限时通过 truncated 标记截断,调用方据此提示用户细化关键词。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
kw | string | 是 | - | 关键词,1–20 字符,超出返回 4002 |
api_key | string | 是 | - | 平台 Key |
返回 kw、count、truncated 与 items 数组,条目含 kind、char、name、tags、category、category_name。
GET /api/fuhao/search?kw=星星&api_key=YOUR_API_KEY把一段文本按指定风格映射为装饰字符。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
text | string | 是 | - | 待转换文本,最多 64 字符 |
style | string | 否 | 全部风格 | 风格 id,可用逗号、中文逗号或空格分隔多个 |
api_key | string | 是 | - | 平台 Key |
style 缺省时对全部十种风格各生成一份结果;显式传入时逐项校验,任一 id 不在清单中即整体返回 4002,错误信息会点出具体不支持的风格。重复 id 会被去重。style 传空字符串与不传等价。
GET /api/fuhao/fancy?text=Abc&style=bold,fraktur&api_key=YOUR_API_KEY从全库或指定分类中随机抽取若干条目,适合做「换一批」交互。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
cat | string | 否 | 全库 | 分类 id,传入未收录值返回 4004 |
n | int | 否 | 1 | 抽样数量,取值 1–20,越界返回 4002 |
api_key | string | 是 | - | 平台 Key |
GET /api/fuhao/random?cat=xingyue&n=5&api_key=YOUR_API_KEYstats 返回分类数、符号总数、颜文字数、情绪分组数、风格数、风格 id 列表,以及搜索上限 80、文本上限 64、随机上限 20 三个硬性约束,可用来在客户端生成校验规则。ping 免鉴权,返回 pong、版本号与服务器时间,仅用于探活。
GET /api/fuhao/stats?api_key=YOUR_API_KEYtruncated 标记,不提供翻页参数。n 取值 1–20,缺省 1;page 上限 100000,page_size 上限由实现常量约束。page 与 page_size 按严格整数解析,传 1.0、abc 或超出范围都会返回 4002,不会回退默认值;只有参数为空或缺省时才取默认。cat 传数字会被当作字符串去比对分类 id,未命中即返回 4004,错误信息中会回显传入值。fancy 的多风格分隔符兼容英文逗号、中文逗号与空白,但风格 id 本身必须小写匹配,拼写错误会导致整体失败而非跳过。note 已作提示,前端应准备降级展示。原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。