- 品牌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 接口,开箱即用,无需修改 EyouCMS 内核代码。
核心功能
| 功能 | 说明 |
|---|---|
| 文章发布接口 | POST 请求即可发布一篇完整文章,返回文章 ID 与访问 URL |
| 栏目列表接口 | GET 接口拉取站点全部文章栏目,便于第三方系统选择 typeid |
| API 密钥自动生成 | 安装即自动生成 ak_ / sk_ 密钥对,支持一键重置 Secret |
| HMAC 签名验证 | 每个请求基于 ApiKey + Timestamp + Secret + Body 生成签名,防篡改 |
| 时间戳防重放 | 请求有效期 5 分钟,超时拒绝,杜绝抓包重放攻击 |
| 完整 SEO 字段 | 支持 seo_title / seo_keywords / seo_description / tags / 自定义文件名 |
| 文章属性全开放 | 头条 / 推荐 / 特荐 / 置顶 / 加粗 / 跳转 / 阅读权限 / 排序值 / 自定义发布时间 |
| 事务安全 | 主表与内容副表事务写入,失败自动回滚,杜绝脏数据 |
| 自动更新 Sitemap | 发布成功后自动调用站点地图生成,新文章秒级提交搜索引擎 |
| 一键启用/禁用 | 后台开关控制 API 服务,关闭后所有外部请求拒绝响应 |
接口列表
| 方法 | 接口地址 | 用途 |
|---|---|---|
| POST | /index.php?m=plugins&c=Api&a=publish&_weapp=ArticleApi | 发布一篇文章 |
| GET | /index.php?m=plugins&c=Api&a=categories&_weapp=ArticleApi | 获取文章栏目列表 |
支持的文章字段
| 字段 | 必填 | 说明 |
|---|---|---|
| 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 |
安全机制
| 机制 | 说明 |
|---|---|
| 双密钥体系 | ApiKey 用于身份识别,ApiSecret 仅参与签名计算,全程不传输 |
| 请求签名 | 签名算法:md5(ApiKey + Timestamp + ApiSecret + Body) |
| 时间戳校验 | 服务端校验 Timestamp 与本机时间差不超过 5 分钟 |
| 服务开关 | 可一键禁用 API,紧急情况立即关闭外部入口 |
| Secret 重置 | 怀疑泄露时一键重置 Secret,旧密钥立即失效 |
请求示例(PHP)
$apiKey = 'ak_xxxxxxxxxxxxxxxxxxxxxxxx'; $apiSecret = 'sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'; $url = 'https://www.yoursite.com/index.php?m=plugins&c=Api&a=publish&_weapp=ArticleApi'; $body = json_encode([ 'title' => '通过API发布的第一篇文章', 'typeid' => 2, 'content' => '<p>这是文章正文,支持 HTML 标签。</p>', 'seo_keywords' => 'API,远程发布,EyouCMS', 'tags' => '接口,自动化', 'is_recom' => 1, ], JSON_UNESCAPED_UNICODE); $timestamp = time(); $signature = md5($apiKey . $timestamp . $apiSecret . $body); $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => $body, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-Api-Key: ' . $apiKey, 'X-Timestamp: ' . $timestamp, 'X-Signature: ' . $signature, ], ]); echo curl_exec($ch);
响应示例
{
"code": 0,
"msg": "发布成功",
"data": {
"aid": 128,
"url": "/index.php?m=home&c=View&a=index&aid=128"
}
}错误码说明
| 错误码 | 含义 |
|---|---|
| 0 | 成功 |
| 1001 | 签名验证失败 |
| 1002 | 时间戳过期 |
| 1003 | API 密钥无效 |
| 1004 | API 已禁用 |
| 2001 | 缺少必填参数 |
| 2002 | 栏目不存在 |
| 5001 | 服务器内部错误 |
使用方式
Step 1. 安装并启用插件,系统自动生成 ApiKey 与 ApiSecret
Step 2. 进入"应用中心 → 文章远程发布接口 → API配置",复制密钥与接口地址
Step 3. 在第三方系统按签名规则发起 POST 请求
完成! 文章自动入库,自动更新 sitemap
适用场景
- 对接 AI 写作平台(ChatGPT / Claude / 文心一言 / Kimi 等)自动生成并发布文章
- 对接采集软件(火车头 / 八爪鱼 / 后羿采集器 / 自研爬虫)批量入库
- 多 EyouCMS 站点内容同步分发
- 从 Excel / CSV / Markdown 文档批量导入历史文章
- 自媒体团队内部 CMS 推送至外部 EyouCMS 站点
- 自动化定时任务(Python/Node 脚本)按计划发布
兼容性
- EyouCMS v1.7.6 及以上版本
- 支持 PHP 7.0 - 8.x
- 支持任何能发起 HTTP 请求的客户端语言(PHP / Python / Node.js / Java / Go / Shell ...)
- 不修改 EyouCMS 任何核心文件,卸载干净无残留
后台截图
(请在此处插入 API配置页面、密钥管理、调用示例等后台截图)
-
1、发货方式:购买后,请去绑定域名的网站后台>插件应用>已购买插件里安装;
2、授权范围:插件授权包含授权域名下的子域名(小程序相关插件除外);
3、域名修改:第一次修改免费(限购买30天内);30天后两年内修改:均按插件最新价格的5折算;两年后修改:按插件最新价格的8折算。插件价格低于10元时,均按照10元算。
4、退款规则:请在仔细了解产品功能并确定需要购买后再付款购买,如果不是功能问题恕不提供退款服务;
5、免责声明:第三方开发者出售的插件售后均有该开发者承担,如果插件资源和包含的图片素材损害了您的权益,请联系网站客服确认处理;
6、禁止行为:请勿使用盗版插件,轻则有木马漏洞,重则对你的系统核心文件造成损坏,这类行为导致的后果官方概不负责。







