创建草稿（帖子）

创建草稿时，如果数据库已经有 createType=1 的草稿，并且为空时（无内容、无文件、无扩展内容），则本次创建将直接返回该草稿。

createType=2 表示为用户主动创建的草稿。

请求参数

Header 参数

X-Fresns-App-Id

string

必需

密钥 App ID
密钥位置：控制面板->应用中心->应用密钥

默认值:

X-Fresns-Client-Platform-Id

integer

必需

平台编号，与密钥的「平台」匹配

默认值:

X-Fresns-Client-Version

string

必需

你的客户端版本号，推荐使用语义化版本号

默认值:

X-Fresns-Client-Device-Info

string

必需

交互设备信息 session_logs > device_info
压缩 Object 信息为字符串传参

默认值:

X-Fresns-Aid

string

可选

账号参数（留空则视为未登录账号）

默认值:

X-Fresns-Aid-Token

string

可选

账号身份凭证（传参 aid 时必传）

默认值:

X-Fresns-Uid

integer

可选

用户参数（留空则视为未登录用户）

默认值:

X-Fresns-Uid-Token

string

可选

用户身份凭证（传参 uid 时必传）

默认值:

X-Fresns-Signature

string

签名

必需

X-Fresns-Signature-Timestamp

string

必需

签名生成时间（当前 Unix 时间戳，精确到秒或毫秒都支持）

Body 参数application/json

createType

number

必需

创建类型 1.快捷创建 2.编辑器创建

editorUnikey

string

可选

是否插件编辑器，留空为否

postGid

string

可选

小组，默认选中了小组

postTitle

string

标题，默认自带标题

可选

postIsComment

boolean

可选

默认配置：是否可以评论帖子

postIsCommentPublic

boolean

可选

默认配置：是否公开评论
不公开则仅帖子作者可见

postQuotePid

string

可选

引用的帖子 PID
非必填

content

string

可选

正文内容，默认自带内容

isMarkdown

boolean

可选

默认配置：内容是否为 MD 格式

isAnonymous

boolean

默认配置：是否匿名

可选

map

object

默认配置：位置信息

可选

extends

object (ExtendContent)

默认配置：扩展内容

可选

textBox

array[object (ExtendContentItem) {17}]

必需

infoBox

array[object (ExtendContentItem) {17}]

必需

interactionBox

array[object (ExtendContentItem) {17}]

必需

archives

array[object (ExtendParam) {4}]

默认配置：扩展参数

可选

code

string

标识码

可选

name

string

名称

可选

description

string

描述

可选

value

string

参数值

可选

示例

{
    "createType": 0,
    "editorUnikey": "string",
    "postGid": "string",
    "postTitle": "string",
    "postIsComment": true,
    "postIsCommentPublic": true,
    "postQuotePid": "string",
    "content": "string",
    "isMarkdown": true,
    "isAnonymous": true,
    "map": {},
    "extends": {
        "textBox": [
            {
                "eid": "string",
                "type": 0,
                "textContent": "string",
                "textIsMarkdown": true,
                "infoType": 0,
                "infoTypeString": "string",
                "cover": "string",
                "title": "string",
                "titleColor": "string",
                "descPrimary": "string",
                "descPrimaryColor": "string",
                "descSecondary": "string",
                "descSecondaryColor": "string",
                "buttonName": "string",
                "buttonColor": "string",
                "position": 0,
                "accessUrl": "string"
            }
        ],
        "infoBox": [
            {
                "eid": "string",
                "type": 0,
                "textContent": "string",
                "textIsMarkdown": true,
                "infoType": 0,
                "infoTypeString": "string",
                "cover": "string",
                "title": "string",
                "titleColor": "string",
                "descPrimary": "string",
                "descPrimaryColor": "string",
                "descSecondary": "string",
                "descSecondaryColor": "string",
                "buttonName": "string",
                "buttonColor": "string",
                "position": 0,
                "accessUrl": "string"
            }
        ],
        "interactionBox": [
            {
                "eid": "string",
                "type": 0,
                "textContent": "string",
                "textIsMarkdown": true,
                "infoType": 0,
                "infoTypeString": "string",
                "cover": "string",
                "title": "string",
                "titleColor": "string",
                "descPrimary": "string",
                "descPrimaryColor": "string",
                "descSecondary": "string",
                "descSecondaryColor": "string",
                "buttonName": "string",
                "buttonColor": "string",
                "position": 0,
                "accessUrl": "string"
            }
        ]
    },
    "archives": [
        {
            "code": "string",
            "name": "string",
            "description": "string",
            "value": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8080/api/v2/editor/post/create' \
--header 'X-Fresns-App-Id;' \
--header 'X-Fresns-Client-Platform-Id;' \
--header 'X-Fresns-Client-Version;' \
--header 'X-Fresns-Client-Device-Info;' \
--header 'X-Fresns-Aid: ' \
--header 'X-Fresns-Aid-Token: ' \
--header 'X-Fresns-Uid: ' \
--header 'X-Fresns-Uid-Token: ' \
--header 'X-Fresns-Signature;' \
--header 'X-Fresns-Signature-Timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "createType": 0,
    "editorUnikey": "string",
    "postGid": "string",
    "postTitle": "string",
    "postIsComment": true,
    "postIsCommentPublic": true,
    "postQuotePid": "string",
    "content": "string",
    "isMarkdown": true,
    "isAnonymous": true,
    "map": {},
    "extends": {
        "textBox": [
            {
                "eid": "string",
                "type": 0,
                "textContent": "string",
                "textIsMarkdown": true,
                "infoType": 0,
                "infoTypeString": "string",
                "cover": "string",
                "title": "string",
                "titleColor": "string",
                "descPrimary": "string",
                "descPrimaryColor": "string",
                "descSecondary": "string",
                "descSecondaryColor": "string",
                "buttonName": "string",
                "buttonColor": "string",
                "position": 0,
                "accessUrl": "string"
            }
        ],
        "infoBox": [
            {
                "eid": "string",
                "type": 0,
                "textContent": "string",
                "textIsMarkdown": true,
                "infoType": 0,
                "infoTypeString": "string",
                "cover": "string",
                "title": "string",
                "titleColor": "string",
                "descPrimary": "string",
                "descPrimaryColor": "string",
                "descSecondary": "string",
                "descSecondaryColor": "string",
                "buttonName": "string",
                "buttonColor": "string",
                "position": 0,
                "accessUrl": "string"
            }
        ],
        "interactionBox": [
            {
                "eid": "string",
                "type": 0,
                "textContent": "string",
                "textIsMarkdown": true,
                "infoType": 0,
                "infoTypeString": "string",
                "cover": "string",
                "title": "string",
                "titleColor": "string",
                "descPrimary": "string",
                "descPrimaryColor": "string",
                "descSecondary": "string",
                "descSecondaryColor": "string",
                "buttonName": "string",
                "buttonColor": "string",
                "position": 0,
                "accessUrl": "string"
            }
        ]
    },
    "archives": [
        {
            "code": "string",
            "name": "string",
            "description": "string",
            "value": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

detail

object (PostLog)

必需

示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "detail": {
            // 通用数据结构->帖子日志信息 或者 评论日志信息
        }
    }
}