- 品牌Eyoucms
- 语言PHP
- 数据库Mysql
- 环境适用于易优 v1.7.6 及以上版本系统
- 大小21.38KB
- 版本号1.0.0
- 编码UTF-8
- 源文件 完全开源(含全部源文件)
文章远程发布接口
为EyouCMS提供安全、稳定、易接入的文章发布API,让第三方系统、采集工具、AI写作平台直接推送文章到您的站点
为什么需要这个插件?
EyouCMS 后台手动发布文章效率低,无法满足以下场景:
- 批量发布 — 从 Excel、Word、Markdown 文档批量导入文章
- AI 写作对接 — ChatGPT、文心一言、Kimi 等 AI 生成内容自动推送到网站
- 采集工具对接 — 火车头、八爪鱼、自研爬虫直接发布到 EyouCMS
- 多站点同步 — 一个内容源,同步发布到多个 EyouCMS 站点
- 自媒体矩阵 — Python / Node.js / PHP 脚本定时推送内容
本插件提供一套简单易用的 HTTP API 接口,一个 Token 即可调用,开箱即用,无需修改 EyouCMS 内核代码。
核心功能
| 功能 | 说明 |
|---|---|
| 文章发布接口 | POST 请求即可发布一篇完整文章,返回文章 ID 与访问 URL |
| 栏目列表接口 | GET 接口拉取站点全部文章栏目,便于第三方系统选择 typeid |
| 极简认证 | 支持 Authorization: Bearer Token 和 ?api_token=xxx 两种方式,与 WordPress / Ghost 等主流 CMS 一致 |
| API Token 自动生成 | 安装即自动生成 Token,支持一键重置,旧 Token 立即失效 |
| 完整 SEO 字段 | 支持 seo_title / seo_keywords / seo_description / tags / 自定义文件名 |
| 自动 SEO 描述 | 未填写 seo_description 时自动从正文截取,省去手动填写 |
| 文章属性全开放 | 头条 / 推荐 / 特荐 / 置顶 / 加粗 / 跳转 / 阅读权限 / 排序值 / 自定义发布时间 |
| 事务安全 | 主表与内容副表事务写入(InnoDB),失败自动回滚,杜绝脏数据 |
| 自动更新 Sitemap | 发布成功后自动调用站点地图生成,新文章秒级提交搜索引擎 |
| 一键启用/禁用 | 后台开关控制 API 服务,关闭后所有外部请求拒绝响应 |
接口列表
| 方法 | 接口地址 | 用途 |
|---|---|---|
| POST | /index.php/plugins/Api/publish | 发布一篇文章 |
| GET | /index.php/plugins/Api/categories | 获取文章栏目列表 |
认证方式
支持两种认证方式,任选其一,一个 Token 搞定:
| 方式 | 用法 |
|---|---|
| Authorization Header(推荐) | 请求头添加 Authorization: Bearer 您的Token |
| URL 参数(最简单) | URL 末尾加 ?api_token=您的Token,浏览器可直接测试 |
支持的文章字段
| 字段 | 必填 | 说明 |
|---|---|---|
| title | 是 | 文章标题 |
| typeid | 是 | 栏目 ID |
| content | 是 | 文章正文(支持 HTML) |
| seo_title / seo_keywords / seo_description | 否 | SEO 三要素(描述不填则自动截取正文) |
| litpic | 否 | 缩略图 URL |
| tags / author / source | 否 | 标签 / 作者 / 来源 |
| add_time | 否 | 自定义发布时间(任意可被 strtotime 解析的格式) |
| is_head / is_recom / is_special / is_top / is_b / is_jump | 否 | 头条 / 推荐 / 特荐 / 置顶 / 加粗 / 跳转 |
| jumplinks | 否 | 跳转链接(is_jump=1 时生效) |
| htmlfilename | 否 | 自定义 URL 文件名(伪静态/HTML 生成时生效) |
| arcrank / sort_order / click / status | 否 | 阅读权限 / 排序值 / 初始点击量 / 状态 |
| auto_sitemap | 否 | 是否自动更新 sitemap,默认 1 |
安全机制
| 机制 | 说明 |
|---|---|
| Bearer Token | 采用业界标准 Bearer Token 认证,与 WordPress REST API / Ghost API 一致 |
| 时序安全比较 | Token 校验使用 hash_equals(),防止时序攻击 |
| 服务开关 | 可一键禁用 API,紧急情况立即关闭外部入口 |
| Token 重置 | 怀疑泄露时一键重置 Token,旧 Token 立即失效 |
| 事务保护 | InnoDB 事务写入,失败自动回滚,数据完整性有保障 |
请求示例
方式一:Token 放 URL(最简单,适合快速测试)
curl -X POST "https://www.yoursite.com/index.php/plugins/Api/publish?api_token=sk_xxxx" \
-H "Content-Type: application/json" \
-d '{"title":"测试文章","typeid":2,"content":"<p>正文内容</p>"}'方式二:Bearer Token(推荐,更安全)
curl -X POST "https://www.yoursite.com/index.php/plugins/Api/publish" \
-H "Authorization: Bearer sk_xxxx" \
-H "Content-Type: application/json" \
-d '{
"title": "通过API发布的第一篇文章",
"typeid": 2,
"content": "<p>这是文章正文,支持 HTML 标签。</p>",
"seo_keywords": "API,远程发布,EyouCMS",
"tags": "接口,自动化",
"is_recom": 1
}'PHP 示例
$token = 'sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'; $url = 'https://www.yoursite.com/index.php/plugins/Api/publish'; $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'Authorization: Bearer ' . $token, ], CURLOPT_POSTFIELDS => json_encode([ 'title' => '通过API发布的第一篇文章', 'typeid' => 2, 'content' => '<p>文章正文</p>', ], JSON_UNESCAPED_UNICODE), ]); echo curl_exec($ch);
Python 示例
import requests
resp = requests.post(
'https://www.yoursite.com/index.php/plugins/Api/publish',
headers={'Authorization': 'Bearer sk_xxxx'},
json={'title': '文章标题', 'typeid': 2, 'content': '<p>正文</p>'}
)
print(resp.json())响应示例
{
"code": 0,
"msg": "发布成功",
"data": {
"aid": 128,
"url": "/index.php?m=home&c=View&a=index&aid=128"
}
}错误码说明
| 错误码 | 含义 |
|---|---|
| 0 | 成功 |
| 1001 | 缺少认证参数 |
| 1003 | API 密钥无效 |
| 1004 | API 已禁用 |
| 1005 | API 未配置密钥 |
| 2001 | 缺少必填参数 |
| 2002 | 栏目不存在 |
| 5001 | 服务器内部错误 |
使用方式
Step 1. 安装并启用插件,系统自动生成 API Token
Step 2. 进入"应用中心 → 文章远程发布接口 → API配置",复制 Token 与接口地址
Step 3. 在第三方系统用 Bearer Token 或 URL 参数发起请求
完成! 文章自动入库,自动更新 sitemap
适用场景
- 对接 AI 写作平台(ChatGPT / Claude / 文心一言 / Kimi / DeepSeek 等)自动生成并发布文章
- 对接采集软件(火车头 / 八爪鱼 / 后羿采集器 / 自研爬虫)批量入库
- 多 EyouCMS 站点内容同步分发
- 从 Excel / CSV / Markdown 文档批量导入历史文章
- 自媒体团队内部 CMS 推送至外部 EyouCMS 站点
- 自动化定时任务(Python / Node / PHP 脚本)按计划发布
兼容性
- EyouCMS v1.7.6 及以上版本
- 支持 PHP 7.0 - 8.x
- 支持任何能发起 HTTP 请求的客户端语言(PHP / Python / Node.js / Java / Go / Shell ...)
- 不修改 EyouCMS 任何核心文件,卸载干净无残留
-
1、发货方式:购买后,请去绑定域名的网站后台>插件应用>已购买插件里安装;
2、授权范围:插件授权包含授权域名下的子域名(小程序相关插件除外);
3、域名修改:第一次修改免费(限购买30天内);30天后两年内修改:均按插件最新价格的5折算;两年后修改:按插件最新价格的8折算。插件价格低于10元时,均按照10元算。
4、退款规则:请在仔细了解产品功能并确定需要购买后再付款购买,如果不是功能问题恕不提供退款服务;
5、免责声明:第三方开发者出售的插件售后均有该开发者承担,如果插件资源和包含的图片素材损害了您的权益,请联系网站客服确认处理;
6、禁止行为:请勿使用盗版插件,轻则有木马漏洞,重则对你的系统核心文件造成损坏,这类行为导致的后果官方概不负责。







