外部内容注入 API

第三方系统把内容传入控制台：指定 tab、填好表单、勾好平台、附上图片/视频 URL，自动用默认浏览器打开控制台展示对应 tab。

工作流程

① 外部系统 POST /api/external/inject 提交内容

→

② 服务器返回 10 分钟有效的 ?draft=TOKEN 短链

→

③ 用默认浏览器打开短链，控制台自动切换 tab、填充内容、勾选平台

内容经服务器一次性 token 中转，无 URL 长度限制，长文/多图安全
token 有效期 10 分钟，拉取一次即销毁（不可重放）
未登录用户打开短链：先进登录页，登录成功后自动回到控制台继续载入内容

端点 1 · 提交内容

POST /api/external/inject Content-Type: application/json

请求体

字段	类型	说明
`tab`	string	必填 `DYNAMIC`（动态）/ `ARTICLE`（文章）/ `VIDEO`（短视频）
`platforms`	string[]	必填选中平台，用平台枚举名（见下方平台枚举）
`data`	object	必填表单内容，字段随 tab 区分（见下表）

data 字段（DYNAMIC / VIDEO）

字段	类型	说明
`title`	string	可选标题，≤200 字
`content`	string	必填正文，≤20000 字
`tags`	string[]	可选标签，≤20 个、每个 ≤30 字
`images`	Media[]	可选图片，仅接受 http(s) 外部 URL
`videos`	Media[]	可选视频，仅接受 http(s) 外部 URL

data 字段（ARTICLE）

字段	类型	说明
`title`	string	必填标题，≤200 字
`digest`	string	可选摘要，≤500 字
`htmlContent`	string	可选富文本 HTML 正文
`markdownContent`	string	可选或传 Markdown 正文（无 htmlContent 时自动转换）
`images`	Media[]	可选图片，≤20 张
`cover`	Media	可选封面，不传则取第一张图
`tags`	string[]	可选标签
`original`	boolean	可选声明原创
`allowComment`	boolean	可选允许评论

Media 对象

{ "url": "https://...", "name": "文件名（可选）", "type": "MIME（可选）", "size": 字节数（可选） }

url 必须为 http(s) 开头，其余字段按白名单清洗、长度截断。

响应（200）

{
  "ok": true,
  "url": "https://guangbo.7373.com.cn/?draft=xxxx",
  "token": "xxxx",
  "ttl": 600
}

用默认浏览器打开 url 即完成「自动打开控制台并展示对应 tab」。

打开默认浏览器命令

macOS：open "https://guangbo.7373.com.cn/?draft=xxxx"

Windows：start https://guangbo.7373.com.cn/?draft=xxxx

错误码：400 参数非法（tab 无效 / 内容为空）· 401 API Key 不匹配（若已配置）· 429 同 IP 每分钟超过 20 次

端点 2 · 一次性拉取

GET /api/draft/{token} 一般由控制台自动调用，无需手动请求

{
  "draft": { "tab": "DYNAMIC", "platforms": ["..."], "data": { ... } }
}

拉取即销毁：重复访问返回 404。

平台枚举（节选）

分组	枚举名（= 控制台「选择平台」列表中的 name）
动态	`DYNAMIC_WEIBO` 微博 · `DYNAMIC_ZHIHU` 知乎 · `DYNAMIC_BILIBILI` 哔哩哔哩 · `DYNAMIC_REDNOTE` 小红书 · `DYNAMIC_TOUTIAO` 今日头条 · `DYNAMIC_WEIXIN` 微信公众号 · `DYNAMIC_X` X …
文章	`ARTICLE_WEIBO` · `ARTICLE_ZHIHU` · `ARTICLE_BILIBILI` · `ARTICLE_JUEJIN` 掘金 · `ARTICLE_TOUTIAO` · `ARTICLE_CSDN` · `ARTICLE_CNBLOGS` 博客园 …
短视频	`DYNAMIC_DOUYIN` 抖音 · `DYNAMIC_KUAISHOU` 快手 · `DYNAMIC_WEIXINCHANNEL` 微信视频号 …

完整清单以控制台右侧「选择平台」列表为准（枚举名 = 列表项 name）。

示例

curl -X POST https://guangbo.7373.com.cn/api/external/inject \
  -H 'Content-Type: application/json' \
  -d '{
    "tab": "DYNAMIC",
    "platforms": ["DYNAMIC_WEIBO", "DYNAMIC_ZHIHU"],
    "data": {
      "title": "今日简讯",
      "content": "这是一条由外部 API 自动注入的动态。",
      "tags": ["简讯", "自动化"],
      "images": [{ "url": "https://public.7373.com.cn/news/a.jpg", "name": "配图1" }],
      "videos": [{ "url": "https://public.7373.com.cn/news/clip.mp4" }]
    }
  }'

# 返回
{ "ok": true, "url": "https://guangbo.7373.com.cn/?draft=xxxx", "token": "xxxx", "ttl": 600 }

# macOS 用默认浏览器打开
open "https://guangbo.7373.com.cn/?draft=xxxx"

鉴权（每个账号一个 API 密钥）

登录控制台后，左侧「API 密钥」面板可查看自己的密钥（首次进入自动创建），支持显示/隐藏、复制、重新生成、吊销
调用注入接口时携带请求头 X-API-Key: <你的密钥>；密钥绑定你的账号，重新生成或吊销后立即生效
系统存在任何有效密钥后，注入接口强制校验（未带或错误返回 401）；全系统尚无密钥时保持开箱即用
兼容旧全局密钥：在服务器 server/.env 配置 GB_EXTERNAL_KEY 后，该密钥仍可全局使用

示例：curl -X POST ... -H 'X-API-Key: gb_xxxxxxxx...' -d '{...}'

安全说明

仅接受 http(s) 外部 URL 的图片/视频，其余字段一律白名单清洗、长度截断
token 一次性、10 分钟过期，服务器不持久化内容（内存态）
同 IP 每分钟限 20 次注入