模版装修-所有字体
模板字体 - 获取字体列表
获取系统支持的字体列表,用于模板装修中选择字体。
接口信息
- 接口地址:
{your-site-url}/api/skill/theme-liquid/get-all-fonts
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
- 请求方式:
GET
- 说明: 获取所有可用的字体列表。包含两类字体:系统默认字体(
id 以 d- 开头)和自定义上传字体(id 为纯数字)。字体用于模板装修中的文字样式配置。
认证
请求头中需要携带 skill-access-token:
| Header |
值 |
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
无参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/theme-liquid/get-all-fonts' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"fonts": [
{
"id": "d-1",
"name": "Arial, Helvetica",
"family": "Arial, Helvetica, sans-serif",
"items": []
},
{
"id": "d-23",
"name": "Montserrat",
"family": "Montserrat, sans-serif",
"items": [
{
"weight": "400",
"style": "normal",
"url": [
"/Montserrat/montserrat_n4.woff2",
"/Montserrat/montserrat_n4.woff"
]
},
{
"weight": "700",
"style": "normal",
"url": [
"/Montserrat/montserrat_n7.woff2",
"/Montserrat/montserrat_n7.woff"
]
}
]
},
{
"id": "d-25",
"name": "DIN Next",
"family": "DIN Next, sans-serif",
"items": [
{
"weight": "400",
"style": "normal",
"url": [
"/Dinnext/dinnext_n4.woff2"
]
}
]
}
]
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码,200 表示成功 |
message |
String |
执行结果的文字描述 |
data |
Object |
字体数据 |
data 字段
| 字段 |
类型 |
说明 |
fonts |
Array[Object] |
字体列表 |
fonts 子项字段
| 字段 |
类型 |
说明 |
id |
string |
字体 ID。d- 开头为系统默认字体,纯数字为自定义上传字体 |
name |
string |
字体显示名称 |
family |
string |
CSS font-family 值,可直接用于 CSS 样式 |
items |
Array[Object] |
字体资源文件列表。系统默认字体通常为空数组 [],因为使用浏览器内置字体 |
items 子项 - 字体资源文件
| 字段 |
类型 |
说明 |
weight |
string |
字重。400 = 常规,500 = 中等,600 = 半粗,700 = 粗体,900 = 特粗 |
style |
string |
字体样式,normal 为常规 |
url |
Array[string] |
字体文件路径数组,每个元素为 .woff2 或 .woff 格式的相对路径。完整 URL 需通过 public_url 拼接 |
注意事项
- 系统默认字体(
id 以 d- 开头)的 items 通常为空,因为使用操作系统/浏览器内置字体
- 自定义上传或内置 Web 字体(如 Montserrat、DIN Next、Futura 等)的
items 包含字体文件资源
family 字段可直接用作 CSS 的 font-family 属性值