本文档非官方出品，主要由 AI 辅助编写，不保证绝对准确。如有疑问，请以 kernel/api/ 中的源码为准。

如果您觉得本文档有帮助，可以考虑赞助支持：爱发电

获取集市模板列表

端点

/api/bazaar/getBazaarTemplate

源文件 (GitHub)

接口描述

此 API 端点用于从思源笔记官方集市获取可用的模板列表。模板是预定义的文档结构，可以在新建文档时快速应用，以提高写作效率。支持按关键词搜索。

认证与授权

此接口需要满足以下条件才能访问:

1. 用户认证 (model.CheckAuth): 需要有效的用户认证,并通过 Authorization HTTP 头部传递 API Token

请求方法

POST

请求参数

请求体应为 JSON 格式，包含以下字段：

参数名	类型	必需	描述
keyword	string	否	搜索关键词，用于在模板名称、描述、作者中进行模糊匹配。为空时返回所有模板

返回值

参数名	类型	描述
code	number	返回码。0: 成功; -1: 服务器错误
msg	string	返回信息。失败时包含错误信息
data	object	返回数据

data 字段内容:

参数名	类型	描述
packages	object[]	模板包信息数组。每个包包含以下字段:

packages 数组中每个对象的字段:

参数名	类型	描述
name	string	包名
author	string	作者
version	string	版本号
displayName	string	显示名称
description	string	描述
repoURL	string	仓库地址
repoHash	string	仓库哈希
iconURL	string	图标地址
funding	object	赞助信息(可选)
installed	boolean	是否已安装
hasUpdate	boolean	是否有更新

示例

请求示例 (获取所有模板)

POST /api/bazaar/getBazaarTemplate
Content-Type: application/json
Authorization: Token your-token

{
  "keyword": ""
}

请求示例 (搜索特定模板)

POST /api/bazaar/getBazaarTemplate
Content-Type: application/json
Authorization: Token your-token

{
  "keyword": "report"
}

返回示例 (成功)

{
  "code": 0,
  "msg": "",
  "data": {
    "packages": [
      {
        "name": "report-template",
        "author": "YourName",
        "version": "1.0.0",
        "displayName": "周报模板", 
        "description": "一个用于快速生成周报的模板。",
        "repoURL": "https://github.com/yourname/report-template",
        "repoHash": "abcdef1234567890",
        "iconURL": "preview.png",
        "funding": {},
        "installed": true,
        "hasUpdate": false
      }
      // ... more packages
    ]
  }
}

返回示例 (失败)

{
  "code": -1,
  "msg": "获取模板列表失败",
  "data": null
}

错误码说明

错误码	说明
0	成功
1	安装失败
-1	服务器错误

备注

• 返回的模板列表会根据用户当前安装状态显示 installed 和 hasUpdate 标记
• 搜索是模糊匹配,会在模板名称、描述、作者等字段中查找关键词
• 如果要获取已安装的模板列表,请使用 /api/bazaar/getInstalledTemplate 接口
• 模板安装后可以在新建文档时直接使用