Windfonts 官方 API 文档

诗语 — Thu, 01 Aug 2024 07:38:10 +0000

基本概念

Windfonts 文风字体服务是一项可以像请求前端资源库的在线字体（web fonts）服务。

字体列表

当前接口可通过参数分页查询文风字体库的字体列表

请求地址

POST   https://app.windfonts.com/api/fonts/list

查询条件

接口支持查询参数如下

Body	属性类型	属性描述	是否必传
pageData	object`{page:number,size:number}`	分页信息	是
tags	string	标签	否
category	string	分类	否
keyword	string	关键词	否

提示: 你可以一次传多个参数.

查询参数示例

{
  "pageData": {
    "page": 1,
    "size": 5
  }
}

响应数据

该接口返回的是一个对象结构

数据返回结构

属性名	数据类型	描述
code	string	响应状态码
message	number	响应信息状态信息
data	object	数据主体，数组对象

data

属性名	数据类型	描述
dataList	array	字体列表信息
page	number	分页，当前第几页
pageTotal	number	总页数
total	number	字体总数

dataList

属性名	数据类型	描述
id	string	唯一 id
name	string	字体名称
fontFamily	string	字体使用名称 – 可用于设置 css 属性 font-family
fontSubfamily	string	子字体名称 – 可用于设置 css 属性 font-weight
version	string	版本号
copyright	string	版权信息
description	string	描述信息
designer	string	设计者
license	string	使用协议地址
tags	string	字体标签
languages	string	字体适用语言
category	string	字体分类
created_at	string	创建时间
updated_at	string	更新时间

下面是一个详细的返回数据例子

{
  "code": 200,
  "data": {
    "page": "number",
    "total": "number",
    "pageTotal": "number",
    "dataList": [
      {
        "name": "string",
        "fontFamily": "string",
        "fontSubfamily": ["string"],
        "version": "string",
        "copyright": "string",
        "description": "string",
        "designer": "string",
        "license": "string | null",
        "category": "string",
        "tags": "string",
        "languages": "string",
        "id": "string",
        "created_at": "date",
        "updated_at": "date"
      }
    ]
  },
  "message": "success"
}

Windfonts 官方 API 文档最先出现在 Windfonts 开发文档。