# 新增栏目 API

新增栏目,使用 POST 发起请求,请求地址为 /api/v1/channels/{siteId}

POST /api/v1/channels/{siteId}

# 请求 URI

参数名 位置 类型 必填 说明
siteId path 整数 站点 Id
apiKey query 字符串 API 密钥,请参考身份认证

# 请求 Body

参数名 类型 必填 说明
parentId 整数 父栏目 Id
channelName 字符串 栏目名称
indexName 字符串 栏目索引
filePath 字符串 生成页面地址
channelFilePathRule 字符串 下级栏目的页面命名规则
contentFilePathRule 字符串 栏目下内容的页面命名规则
groupNames 字符串 栏目组
imageUrl 字符串 栏目图片,存储图片地址
content 字符串 栏目正文,以编辑器提交信息
keywords 字符串 关键字列表,各关键词间用英文逗号“,”分割
description 字符串 页面描述
linkUrl 字符串 外部链接,设置后链接将指向此地址
linkType 字符串 链接类型,设置此栏目的链接与子栏目及内容的关系
channelTemplateId 整数 栏目模板 Id
contentTemplateId 整数 内容模板 Id

# 返回

名称 类型 说明
200 OK Channel 栏目
401 Unauthorized Error 认证错误
404 NotFound Error 资源不存在错误
400 BadRequest Error 参数错误

# 示例 1

以下请求将在站点首页下创建新栏目。

POST /api/v1/channels/1476
Content-Type: application/json
X-SS-API-KEY: 7cd22002-27a7-4c5d-ba4d-a1c108a20eaf

{
  "channelName": "栏目标题"
}

# 示例 2

以下请求将在站点指定栏目下创建新栏目,同时设置栏目索引。

POST /api/v1/channels/1476
Content-Type: application/json
X-SS-API-KEY: 7cd22002-27a7-4c5d-ba4d-a1c108a20eaf

{
  "parentId": 1481,
  "channelName": "栏目标题",
  "channelIndex": "栏目索引"
}
上次更新: 2023/11/16 上午11:17:30