| 名称 | 类别 | AppID | 城市 | 出口代理 | 状态 | 操作 |
|---|
web-publisher/watch-login.js 在运行。
| 账号 | 状态 | 公众号 | Cookie 到期 | 操作 |
|---|
| 时间 | 账号 | 模式 | 城市 | 文章 | 状态 | 结果 / 原因 |
|---|
direct 表示显式直连(适用:服务器本身就在该城市,出口即本机公网 IP);
账号和城市都未配置且未声明 direct 时,推送与网页发布都会拒绝执行(绝不静默直连)。
目标城市需要有真实运行的代理机(如该地域云服务器上的 squid / 静态代理商的线路);账号密码由代理商提供,无账密留空。
注意:带账密的代理会自动拼接成 http://user:pass@IP:端口 格式存库。
| 城市 | 代理出口 | 备注 | 操作 |
|---|
style 字段填主题名;不填则用带 ★ 的默认主题。主题文件存在宿主机 styles/ 目录,可直接备份。| 主题名 | 更新时间 | 操作 |
|---|
X-API-Key: ...POST /api/push — mode: draft(草稿箱,推荐)/ publish(发布到历史消息,消耗发布额度)/ publish+notify=true(群发通知粉丝,进搜一搜索引,订阅号每天仅1次额度);accounts 可传账号名数组或 "all";articles 1~8 篇(多篇自动合成一条多图文,第 1 篇是头条)。需要原创声明时改用下方 push-web,文章参数完全一致。
curl -X POST http://localhost:3000/api/push \
-H "Content-Type: application/json" \
-H "X-API-Key: 你的key" \
-d '{
"mode": "draft",
"accounts": ["acct_a", "acct_b"], // 或 "all"
"articles": [
{
"title": "文章标题",
"author": "作者",
"cover": "images/cover.png", // 必填!封面图:data-images文件名 / http图片URL / base64 data URI
"content": "## 正文\n\nMarkdown 内容,图片写 ",
"source_url": "https://...", // 可选,阅读原文
"digest": "摘要", // 可选
"comment": false, // 可选,开启评论区
"mini_program": { // 可选,小程序卡片(自动传图+注入标签)
"appid": "wx...", "path": "pages/index/index",
"title": "卡片标题", "image": "images/card.png", "text": "点击进入"
}
}
]
}'
图片在你本地?用 multipart 形式,一次请求全推:
curl -X POST .../api/push -H "X-API-Key: key" -F 'article={"title":"标题","cover":"head.png","content":"..."}' -F 'head.png=@图片路径'
—— 正文图片直接写文件名,上传同名文件即自动匹配回填;cover 必填(写上传的文件名可复用);
引用了没传的文件名直接报错不静默。详见下方完整文档《形式二》。
返回:{ok, batch_id, results:[{account, ok, media_id | error, err_code}]};
单号失败不影响其他号,详情看推送记录页。
查询批量结果:GET /api/records/batch/{batch_id}(同样需要 X-API-Key);
图片路径按 /data/images、/work/articles 顺序解析,http 地址直接下载转传;
正文支持小程序跳转标签(<a data-miniprogram-appid> / <mp-miniprogram>,不会被链接清洗移除,详见下方完整文档)。
POST /api/push-web — 唯一需要用到它的场景:要声明原创/快捷转载/代点发表。文章部分与 /api/push 完全一致(JSON/multipart 均可),额外支持原创参数;实际只存草稿,随后由本地脚本(publish-web.js)在公众号后台网页里代操作。
curl -X POST http://localhost:3000/api/push-web \
-H "Content-Type: application/json" \
-H "X-API-Key: 你的key" \
-d '{
"accounts": ["acct_a"], // 或 "all"
"original": true, // 可选,声明原创(网页脚本代勾)
"original_scope": "all", // 可选,all=统一全部篇 / first=仅首条(默认 all)
"quick_reprint": false, // 可选,开启快捷转载(必须 original=true)
"web_publish": "draft", // 可选,draft=脚本只存草稿 / publish=脚本代点发表(耗当日额度)
"notify": false, // 可选,发表时群发通知推送给粉丝(必须 web_publish=publish,耗群发额度)
"author": "作者名", // 可选,原创声明作者(必须 original=true,1~8字;不传默认「佚名」)
"articles": [ ... ] // 与 /api/push 完全一致(title/content/cover 必填,1~8 篇)
}'
流程:接口存草稿 → 推送记录出现「网页流程」任务 → 运行
node web-publisher/publish-web.js 账号名 [--publish] → 脚本按标记在网页里声明原创/快捷转载并保存。
需要该账号扫码过一次(登录态保存数天);web_status 在推送记录里跟踪进度。