# 新增内容 API
新增内容,使用 POST
发起请求,请求地址为 /api/v1/contents/{siteId}/{channelId}
。
POST /api/v1/contents/{siteId}/{channelId}
# 请求 URI
参数名 | 位置 | 类型 | 必填 | 说明 |
---|---|---|---|---|
siteId | path | 整数 | 是 | 站点 Id |
channelId | path | 整数 | 是 | 栏目 Id |
apiKey | query | 字符串 | 否 | API 密钥,请参考身份认证 |
# 请求 Body
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
addUserName | 字符串 | 否 | 添加人 |
lastEditUserName | 字符串 | 否 | 修改人 |
writingUserName | 字符串 | 否 | 投稿人 |
lastEditDate | 日期 | 否 | 修改时间 |
taxis | 数字 | 否 | 排序 |
groupNames | 字符串 | 否 | 内容组 |
tagNames | 字符串 | 否 | 标签 |
sourceId | 数字 | 否 | 来源内容 Id,对应内容表的 Id 字段 |
referenceId | 数字 | 否 | 引用内容 Id,对应内容表的 Id 字段 |
isChecked | 字符串 | 否 | 是否终审通过通过 |
checkedLevel | 数字 | 否 | 未终审通过情况下,处于第几级审核状态 |
hits | 数字 | 否 | 总点击量 |
hitsByDay | 数字 | 否 | 日点击 |
hitsByWeek | 数字 | 否 | 周点击 |
hitsByMonth | 数字 | 否 | 月点击 |
lastHitsDate | 日期 | 否 | 最后点击时间 |
title | 字符串 | 是 | 内容标题 |
top | 布尔值 | 否 | 是否置顶内容 |
recommend | 布尔值 | 否 | 是否推荐内容 |
hot | 布尔值 | 否 | 是否热点内容 |
color | 布尔值 | 否 | 是否醒目内容 |
linkUrl | 字符串 | 否 | 外部链接,设置后链接将指向此地址 |
addDate | 日期 | 否 | 添加时间 |
subTitle | 字符串 | 否 | 内容副标题 |
imageUrl | 字符串 | 否 | 内容图片,存储图片地址 |
videoUrl | 字符串 | 否 | 内容视频,存储视频地址 |
fileUrl | 字符串 | 否 | 内容附件,存储附件地址 |
body | 字符串 | 否 | 内容正文,以编辑器提交信息 |
summary | 字符串 | 否 | 内容摘要 |
author | 字符串 | 否 | 作者 |
source | 字符串 | 否 | 来源 |
# 返回
名称 | 类型 | 说明 |
---|---|---|
200 OK | Content | 内容 |
401 Unauthorized | Error | 认证错误 |
404 NotFound | Error | 资源不存在错误 |
400 BadRequest | Error | 参数错误 |
# 示例
# 请求示例
POST /api/v1/contents/1/1
Content-Type: application/json
X-SS-API-KEY: 7cd22002-27a7-4c5d-ba4d-a1c108a20eaf
{
"title": "标题",
"body": "内容正文"
}
# 返回示例
{
"imageUrlCount": 0,
"videoUrlCount": 0,
"fileUrlCount": 0,
"content": "内容正文",
"channelId": 1,
"siteId": 1,
"adminId": 1,
"lastEditAdminId": 0,
"userId": 0,
"taxis": 1,
"groupNames": [],
"tagNames": [],
"sourceId": 0,
"referenceId": 0,
"templateId": 0,
"checked": true,
"checkedLevel": 1,
"hits": 0,
"downloads": 0,
"title": "标题",
"subTitle": "",
"imageUrl": "",
"videoUrl": "",
"fileUrl": "",
"body": "",
"summary": "",
"author": "",
"source": "",
"top": false,
"recommend": false,
"hot": false,
"color": false,
"linkType": "None",
"linkUrl": null,
"addDate": "2024-02-29 09:29:21",
"id": 3,
"guid": "0967b1a3-2170-40e7-8971-8cefc69891bd",
"createdDate": "2024-02-29 09:29:22",
"lastModifiedDate": "2024-04-02 09:13:22"
}