新增-文章

POST

/v1_0/mp/articles

新增-文章

注意1:
请求参数cover 中传递样例为
无图: { type: 0, images: [] }
单图: { type: 1, images: [“地址1”] }
三图: { type: 3, images: [“地址1”，‘地址2’，‘地址3’] }

注意2:
如果发表为正式文章，文章的状态会首先变为待审核状态，即status为1
然后1分钟后系统会自动审核通过，状态成为审核通过，status为2
审核失败状态一般不存在

请求参数

Query 参数

draft

string

可选

文章状态: true-草稿, false-发布

示例值:

false

Header 参数

Authorization

string

必需

Bearer token值例如: Bearer 2d087800-f3a5-4a66-9feb-74404d350943

示例值:

Body 参数application/json

title

string

文章标题

必需

content

string

文章内容

必需

cover

object

文章封面

必需

type

integer

文章封面类型

必需

封面类型 -1:自动，0-无图，1-1张，3-3张

images

array[string]

文章封面地址数组

必需

需要前端在做上传图片动作时单独调用上传文件接口换回来图片地址, 然后放在这里

channel_id

integer

文章频道id

必需

示例

{
  "title": "12345",
  "content": "<p>我是文章内容</p>",
  "cover": {
    "type": 1,
    "images": [
      "http://geek.itheima.net/uploads/1659338630976.jpg"
    ]
  },
  "channel_id": 2
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://geek.itheima.net/v1_0/mp/articles' \
--header 'Authorization: {{GK_ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "12345",
    "content": "<p>我是文章内容</p>",
    "cover": {
        "type": 1,
        "images": [
            "http://geek.itheima.net/uploads/1659338630976.jpg"
        ]
    },
    "channel_id": 2
}'

返回响应

🟢200成功

application/json

Body

data

object

响应数据

必需

string

文章id

必需

message

string

响应消息

必需

示例

{
  "data": {
    "id": "4dff2983-ba86-4e86-8038-c5e8eb368fca"
  },
  "message": "OK"
}

修改于 2022-08-01 07:59:17

获取-文章列表

获取-文章详情