使用 API 向RichCMS发布文章

在RichCMS已经发布的v0.0.4版本中，新增加了 API发布文章的功能，此功能可以通过HTTP API，向RichCMS的系统发布文章，要使用些功能，需要通过以下几步来实现。

一、打开API Token

系统默认未打开api token，在管理后台的“站点管理” -> "安全设置"处，生成Token，记录Token到别处，并保存设置 API Token。

二、API使用方法

请求地址：

post /openapi/v1/article

Content-Type：

application/x-www-form-urlencoded

请求URL参数：

token = 12321321321321 # 后台设置api token
match_tag true or false # 是否自动匹配已有标签
desc_length 100  # description的长度，可以传入文章内容，自动截取前N个字符
is_trad true or false #是否把标题和内容等文本转换为繁体中文。

www-form-urlencoded参数：

  "cate_id":"1",
  "title":"RichCMS是什么系统?有哪些特点?",
  "photo":"",
  "author":"richcms",
  "state":"0",
  "is_hot":"0",
  "seo_title":"",
  "keywords":"richcms api",
  "description":"",
  "content":"<p>这儿是文章下文的内容<br>内容。</p>"
  "cron":"1728524973"

其中：

is_hot 值为：0默认 1 热门;
state值为：0显示，-8为定时发布，-9草稿，-10关闭;
cate_id 后台栏目ID;
cron 为定时发布时的时间戳；

如果选择了定时发布，提交后的文章，会在【内容管理】-【定时文章】处看到定时文章的发布状态。

错误的响应：

{
    "code": 1,
    "msg": "没有传入token",
    "time": 1722847082,
    "body": {
        "pager": {
            "page": 0,
            "count": 0,
            "page_count": 0
        },
        "data": null
    }
}

本地环境使用postman提交的演示图：

至此，站长可以通过此API，快速向自己的网站提交发布文章了，如果你在系统中，使用了标签模块，自动发布文章时，API也会做好标签匹配。

相关文章