# 新增内容 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"
}