添加文章

开发中

POST

http://localhost:8098/admin/post

添加文章。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

title

string

文章标题

必需

<= 256 字符

autoGenerateExcerpt

boolean | null

是否自动生成摘要

必需

默认值:

false

excerpt

string | null

文章摘要

可选

<= 1024 字符

slug

string

文章别名

必需

<= 128 字符

allowComment

boolean

是否允许评论

必需

status

enum<string>

状态

必需

枚举值:

PUBLISHEDDRAFT

visible

enum<string>

可见性

必需

枚举值:

VISIBLEHIDDEN

content

string

文章正文内容（Markdown / PlainText）

必需

categoryId

integer | null

分类 ID

可选

tagIds

array[integer] | null

标签 ID 数组

可选

cover

string | null

封面

可选

<= 512 字符

pinned

boolean | null

是否置顶

可选

默认值:

false

password

string | null

文章密码

可选

<= 64 字符

示例

{
    "title": "string",
    "autoGenerateExcerpt": "false",
    "excerpt": "string",
    "slug": "string",
    "allowComment": true,
    "status": "PUBLISHED",
    "visible": "VISIBLE",
    "content": "string",
    "categoryId": 0,
    "tagIds": [
        0
    ],
    "cover": "string",
    "pinned": "false",
    "password": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8098/admin/post' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "string",
    "autoGenerateExcerpt": "false",
    "excerpt": "string",
    "slug": "string",
    "allowComment": true,
    "status": "PUBLISHED",
    "visible": "VISIBLE",
    "content": "string",
    "categoryId": 0,
    "tagIds": [
        0
    ],
    "cover": "string",
    "pinned": "false",
    "password": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

errMsg

null

必需

data

object

必需

postId

integer

文章 ID

必需

title

string

文章标题

必需

autoGenerateExcerpt

boolean

是否自动生成摘要

必需

excerpt

string

文章摘要

必需

slug

string

文章别名

必需

cover

string | null

文章封面

必需

allowComment

boolean

是否允许评论

必需

pinned

boolean

置顶

必需

status

enum<string>

文章状态

必需

枚举值:

PUBLISHEDDRAFT

visible

enum<string>

文章可见性

必需

枚举值:

VISIBLEHIDDEN

encrypted

boolean

文章是否有密码

必需

password

null

文章密码

必需

始终为 null，密码不会返回

tags

array [object {5}]

文章标签

必需

>= 0 items

createTime

integer

创建时间戳

必需

lastModifyTime

integer | null

最后修改时间

必需

{
    "code": 200,
    "errMsg": null,
    "data": {
        "postId": 4,
        "title": "布速角",
        "autoGenerateExcerpt": false,
        "excerpt": "",
        "slug": "elit laboris aliqua",
        "cover": "laborum Excepteur culpa",
        "allowComment": false,
        "pinned": false,
        "status": "PUBLISHED",
        "visible": "VISIBLE",
        "encrypted": false,
        "password": null,
        "visit": 0,
        "category": {
            "categoryId": 2,
            "displayName": "西各特百族意实",
            "slug": "reprehenderit tempor nostrud in",
            "cover": "dolor eiusmod",
            "unifiedCover": false,
            "postCount": 1
        },
        "tags": [
            {
                "tagId": 5,
                "displayName": "技区具需",
                "slug": "eu%20minim",
                "color": "#00F9A2",
                "postCount": 1
            },
            {
                "tagId": 6,
                "displayName": "商日空表红",
                "slug": "veniam id Duis commodo",
                "color": "#4450Aa",
                "postCount": 1
            }
        ],
        "createTime": 1709479183524,
        "lastModifyTime": null
    }
}

修改于 2024-04-24 09:31:08

文章

删除文章