创建草稿
- 接口地址:
/api/v2/editor/{type}/create - 请求方式:
POST - 传参方式:
Rest+application/json
Headers 可选参数
| 参数名 | 公开模式(是否必传) | 私有模式(是否必传) |
|---|---|---|
| X-Fresns-Aid | YES | YES |
| X-Fresns-Aid-Token | YES | YES |
| X-Fresns-Uid | YES | YES |
| X-Fresns-Uid-Token | YES | YES |
Rest 参数
| 参数名 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| type | String | YES | post 或 comment |
Body 参数
| 参数名 | 类型 | 是否必传 | 帖子说明 | 评论说明 |
|---|---|---|---|---|
| createType | Number | YES | 创建类型 1.快捷创建 2.编辑器创建 | |
| editorFskey | String | NO | 是否插件编辑器,留空为否 | |
| postQuotePid | String | NO | 引用的帖子 PID 非必填 | 帖子专用 |
| postGid | String | NO | 小组,默认选中了小组 | 帖子专用 |
| postTitle | String | NO | 标题,默认自带标题 | 帖子专用 |
| postIsCommentDisabled | Boolean | NO | 是否禁止评论 | 帖子专用 |
| postIsCommentPrivate | Boolean | NO | 是否私有评论 私有则仅评论作者和帖子作者可见 | 帖子专用 |
| commentPid | String | NO | 评论专用 | 评论哪个帖子,必传 |
| commentCid | String | NO | 评论专用 | 留空表示评论帖子 有值表示回复这条评论 |
| content | String | NO | 正文内容,默认自带内容 | |
| isMarkdown | Boolean | NO | 内容是否为 MD 格式 | |
| isAnonymous | Boolean | NO | 是否匿名 | |
| map | Object | NO | 位置信息 | |
| extends | Array | NO | 扩展内容 | |
| archives | Array | NO | 扩展参数 |
接口使用说明
- 创建草稿时,如果数据库已经有
createType=1的草稿,并且为空时(无内容、无文件、无扩展内容),则本次创建将直接返回该草稿。 createType=2表示为用户主动创建的草稿。
返回结果
json
{
"code": 0,
"message": "ok",
"data": {
"detail": {
// 通用数据结构->帖子日志信息 或者 评论日志信息
},
"editControls": {
"isEditDraft": "Boolean / 是否为编辑草稿",
"editableStatus": "Boolean / 是否可编辑",
"editableTime": "String / 剩余可编辑时长,例如 03:00 表示剩余 3 分钟",
"deadlineTime": "String / 剩余可编辑截止具体日期时间,例如 2022-07-01 15:05:00"
}
}
}