首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >数据鱼API · 特殊符号与颜文字接口接入指南

数据鱼API · 特殊符号与颜文字接口接入指南

原创
作者头像
用户12862874
发布于 2026-11-21 21:28:09
发布于 2026-11-21 21:28:09
130
举报

接口简介

「特殊符号与颜文字库」是数据鱼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 不适用。

核心端点详解

分类总览 categories

一次取回三类元数据:分类列表(id、name、desc、count),颜文字按情绪的 moods 分组,以及 fancy_styles 风格表。分类 id 是后续 list 与 random 的入参,风格 id 是 fancy 的入参,建议客户端首次接入时缓存这份清单。

代码语言:javascript
复制
GET /api/fuhao/categories?api_key=YOUR_API_KEY

分页列表 list

按分类返回符号条目,带分页信息,适合做符号选择器或素材列表页。

参数

类型

必填

默认

说明

cat

string

是

-

分类 id,取自 categories 端点

page

int

否

1

页码,从 1 开始,上限 100000

page_size

int

否

实现默认值

每页条数,超过上限返回 4002

api_key

string

是

-

平台 Key

代码语言:javascript
复制
GET /api/fuhao/list?cat=wangming&page=1&page_size=50&api_key=YOUR_API_KEY

关键词搜索 search

在符号名称与标签中做子串检索,单次最多返回 80 条;命中超过上限时通过 truncated 标记截断,调用方据此提示用户细化关键词。

参数

类型

必填

默认

说明

kw

string

是

-

关键词,1–20 字符,超出返回 4002

api_key

string

是

-

平台 Key

返回 kw、count、truncated 与 items 数组,条目含 kind、char、name、tags、category、category_name。

代码语言:javascript
复制
GET /api/fuhao/search?kw=星星&api_key=YOUR_API_KEY

花式字转换 fancy

把一段文本按指定风格映射为装饰字符。

参数

类型

必填

默认

说明

text

string

是

-

待转换文本,最多 64 字符

style

string

否

全部风格

风格 id,可用逗号、中文逗号或空格分隔多个

api_key

string

是

-

平台 Key

style 缺省时对全部十种风格各生成一份结果;显式传入时逐项校验,任一 id 不在清单中即整体返回 4002,错误信息会点出具体不支持的风格。重复 id 会被去重。style 传空字符串与不传等价。

代码语言:javascript
复制
GET /api/fuhao/fancy?text=Abc&style=bold,fraktur&api_key=YOUR_API_KEY

随机抽样 random

从全库或指定分类中随机抽取若干条目,适合做「换一批」交互。

参数

类型

必填

默认

说明

cat

string

否

全库

分类 id,传入未收录值返回 4004

n

int

否

1

抽样数量,取值 1–20,越界返回 4002

api_key

string

是

-

平台 Key

代码语言:javascript
复制
GET /api/fuhao/random?cat=xingyue&n=5&api_key=YOUR_API_KEY

统计与健康检查

stats 返回分类数、符号总数、颜文字数、情绪分组数、风格数、风格 id 列表,以及搜索上限 80、文本上限 64、随机上限 20 三个硬性约束,可用来在客户端生成校验规则。ping 免鉴权,返回 pong、版本号与服务器时间,仅用于探活。

代码语言:javascript
复制
GET /api/fuhao/stats?api_key=YOUR_API_KEY

数据与限制

  • 资源规模:12 个分类、653 个符号、135 条颜文字、16 种情绪分组、10 种花式字风格。
  • 搜索单次最多返回 80 条,超出部分以 truncated 标记,不提供翻页参数。
  • 花式字输入上限 64 字符,超出直接返回 4002 并给出实际长度。
  • 随机抽样 n 取值 1–20,缺省 1;page 上限 100000,page_size 上限由实现常量约束。
  • 内容为静态内置表,不随日期变化,无缓存失效问题;随机端点每次结果可能不同。

典型使用场景

  • 社交工具与输入法皮肤:分类浏览加关键词搜索,给用户提供可复制的装饰符号面板。
  • 昵称与签名生成器:调用花式字端点一次生成多种风格,供用户预览后选择。
  • 内容排版:用分割线与箭头分类取素材,填充文章或海报的视觉分隔。
  • 聊天机器人:随机抽样端点做「换一组颜文字」的互动回应。

注意事项

  • page 与 page_size 按严格整数解析,传 1.0、abc 或超出范围都会返回 4002,不会回退默认值;只有参数为空或缺省时才取默认。
  • cat 传数字会被当作字符串去比对分类 id,未命中即返回 4004,错误信息中会回显传入值。
  • fancy 的多风格分隔符兼容英文逗号、中文逗号与空白,但风格 id 本身必须小写匹配,拼写错误会导致整体失败而非跳过。
  • 花式字依赖 Unicode 码位映射,部分安卓字体或老旧客户端可能显示为空白或方框,统计端点的 note 已作提示,前端应准备降级展示。
  • 关键词搜索只覆盖名称与标签,不检索字符本身;搜「★」未必命中名称为「星星」的条目。
  • 本接口属于数据鱼API平台开发工具类接口,鉴权与响应结构与平台其他接口一致。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 接口简介
  • 端点总览
  • 通用约定
  • 核心端点详解
    • 分类总览 categories
    • 分页列表 list
    • 关键词搜索 search
    • 花式字转换 fancy
    • 随机抽样 random
    • 统计与健康检查
  • 数据与限制
  • 典型使用场景
  • 注意事项
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档