OPC · 内容发布

内容发布（开放 CMS）

用你应用的 API Key 把文章提交到沉思波官网新闻栏目，拿到 https://chensibo.cn/news/<slug>.html 的正式地址。默认先审后发：审核通过前，那个地址对任何人都是 404。

内容计费

前提

在控制台建好应用并通过审核，拿到密钥（opc_sk_ 开头，只在签发那一次回显，服务端存的是哈希）。密钥属于应用，只放服务端，不进浏览器。

内容发布不是「往我们站上发软文」：投的稿会以你的应用名署名，观点归作者，且必须过审核。

适用与不适用

适合

有持续内容输出的开发方：技术周报、产品更新、行业观察；把写作交给 AI 或脚本，人只做审校。

不适合

批量采集转载、SEO 站群、带推广链接的营销稿；需要复杂排版（自定义 HTML / 脚本 / 内嵌组件）的内容。

为什么走「先审后发」

官网新闻栏目是公开可检索的页面，也是搜索引擎和 RSS 的入口。开放写入但不设闸，等于把这块地方交给任何拿到密钥的人。

所以默认口径是三句话：

• 投稿默认进待审队列，审核通过前页面是真 404——不是「界面上不显示但 URL 能打开」；
• 改稿即重审：非信任应用更新自己已上线的稿子，状态会打回待审，避免「先发合规内容、过审后再改」；
• 我们自己的应用可以标成信任应用免审直发，这个标记只在控制台由管理员设置。

步骤

1. 用应用密钥调用

请求头二选一，效果相同：

Authorization: Bearer opc_sk_xxxxxxxx

X-Api-Key: opc_sk_xxxxxxxx

应用处于待审 / 驳回 / 停用状态时调用一律 401；密钥无效同样是 401。

2. 提交一篇

POST /api/open/content/articles
Content-Type: application/json
Authorization: Bearer opc_sk_xxxxxxxx

{
  "title": "AI 内容生产的成本结构正在变化",
  "description": "一句话摘要，会出现在列表页与 RSS。",
  "body_md": "## 小节标题\n\n正文用 markdown 写。",
  "date": "2026-11-05",
  "kind": "daily",
  "section": "行业观察"
}

返回 202 表示已进待审队列：

{ "ok": true, "slug": "2026-11-05-xxx", "status": "pending", "review": "pending" }

信任应用返回 200，status 是 published，回包里直接带 url——落库即上线。

字段口径：

字段	必填	说明
title	是	不超过 120 字
body_md	是	markdown 正文，50–100000 字
description	否	不超过 300 字，列表页与 RSS 用
date	否	YYYY-MM-DD，缺省取当天
kind	否	daily（行业观察，默认）或 news（公司动态）
section	否	领域短标签，不超过 40 字
slug	否	地址标识，a-z 0-9 与短横线，3–81 位；不给则按日期 + 标题生成

正文只认这些 markdown 语法：标题、段落、加粗、行内码、链接、有序 / 无序列表、引用、分隔线。不解析任何 HTML 标签——写 <div> 会被当文字转义显示，不是渲染。

3. 等审核

用同一个密钥查自己提交过的稿子：

GET /api/open/content/articles
Authorization: Bearer opc_sk_xxxxxxxx

回包里每篇带 status、review_note（驳回理由）和 updated_at。状态一共四种：

status	含义	对外可见
pending	待审核	否（404）
published	已上线	是
rejected	已驳回，理由在 review_note	否（404）
withdrawn	已撤回	否（404）

4. 改稿与撤稿

改稿就是同一个 slug 再 POST 一次：字段全量覆盖，状态回到 pending（信任应用除外）。不要新建 slug 重发，否则站上会多一篇重复页。

撤稿：

DELETE /api/open/content/articles/{slug}
Authorization: Bearer opc_sk_xxxxxxxx

撤回是软删（转 withdrawn），页面立刻下线，记录保留可追溯。只能撤自己的稿子。

额度与计量

每次调用记一次用量，与其他开放能力共用同一本账（控制台可见），并按应用设的每日配额（quota_daily）卡口；超了回 429，次日恢复或申请提额。提交接口另有按来源的限频，短时间内猛推同样会 429。

常见错误

状态码	什么时候出现	怎么办
400	缺 title / 正文过短 / date 格式错 / slug 不合法	按 error 字段改，换同一个 slug 重发
401	没带密钥、密钥无效、应用未过审或已停用	检查应用状态与密钥前缀
409	slug 已被别的应用占用	换 slug；这里不会告诉你那篇是谁的
429	超日配额或触发限频	次日再试或申请提额
502	网关层异常	重试同一次请求（同 slug 重发是更新，不会重复发文）

与官方直发通道的区别

站内自动化（每日行业观察）走的是另一条内部通道：不经过审核，落库即上线。两条通道写同一张表，但只有开放通道受审核队列约束。你不需要关心内部通道怎么工作，只要知道：同样的内容，走开放接口提交，就要等审核。

下一步

• 密钥、配额、应用状态都在后台管理文档里；
• 计费口径见计费与额度；
• 想接登录、验证码、静态托管，回接入总览。