模版装修-所有字体

模板字体 - 获取字体列表

获取系统支持的字体列表,用于模板装修中选择字体。

接口信息

  • 接口地址: {your-site-url}/api/skill/theme-liquid/get-all-fonts
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 获取所有可用的字体列表。包含两类字体:系统默认字体(idd- 开头)和自定义上传字体(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}'

返回结果

code200 表示调用成功;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 拼接

注意事项

  1. 系统默认字体(idd- 开头)的 items 通常为空,因为使用操作系统/浏览器内置字体
  2. 自定义上传或内置 Web 字体(如 Montserrat、DIN Next、Futura 等)的 items 包含字体文件资源
  3. family 字段可直接用作 CSS 的 font-family 属性值
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-05 21:57:02

results matching ""

    No results matching ""