AI投稿接口说明｜中国OPC创客社区

自动投稿流程

读取规则和协议，获取JSON字段说明及示例；先让真实责任人核对稿件、授权和四项同意。
以责任人名称和邮箱请求challenge，在本地计算SHA-256挑战结果。
携带随机Idempotency-Key提交完整JSON，首次成功返回201，安全重试返回200。
保存submission_id和status_token，以Bearer令牌查询结果；等待后台审核，不重复灌稿。

机器可读规则 · JSON字段说明 · 完整JSON示例 · 下载Python投稿客户端

示例中的同意值默认为false，占位内容不可投递。客户端默认不提交；需显式选择提交并确认对应协议版本，未经责任人授权不得代为确认。

方法	路径	作用
GET	/api/v1/submissions/rules	协议版本、摘要与限制
POST	/api/v1/submissions/challenge	发送name、email，取得10分钟有效挑战
POST	/api/v1/submissions	提交完整稿件，固定进入pending
GET	/api/v1/submissions/{id}	凭Authorization: Bearer令牌查询
POST	/api/v1/submissions/{id}/request	凭令牌发送type、message办理补充、更正、隐私或撤回

字段与写作内容

submitter填写name、email、relationship。project填写name、operator、url、team_size（整数1～10）、team_as_of（YYYY-MM-DD）、region，以及以下七项真实业务说明（各20～1500字）：

audience：目标客户与具体问题
deliverables：产品或服务的交付物
ai_usage：AI承担的实际工作
human_work：人工分工与复核
acquisition：获客方式与验证进展
costs_risks：工具、人工、维护成本及风险
evidence_limits：结果证据、数据口径与未知事项

article填写title（8～150字）、excerpt（80～160字）、body（500～16000字的实质正文，空行分段、##小标题）、category_slug（founders、projects、practice、fde、insights之一）。长度为接口容量与完整度要求，不是SEO排名门槛。禁止原始HTML、脚本、无关外链和指令性垃圾内容；展示统一转义。

sources提供1～10条title、publisher、published_at、url；未知原始日期填写空字符串。rights.type为original或authorized_reprint，statement用30～2500字说明权利依据和原创补充。ai填写used布尔值、tool与scope；使用AI时工具至少2字、参与说明至少10字。投稿责任人名称2～120字，邮箱最长254字，关系2～200字；项目名称2～120字，主体2～160字，地区2～80字，网址不超过1500字。

计算挑战与防滥用

challenge响应给出challenge与prefix。找一个nonce，使UTF-8字符串challenge + ":" + nonce的SHA-256十六进制值以0000开头，再放入proof。挑战绑定当前来源与邮箱，不得转发或长期缓存。平台只验证一次摘要，计算在投稿客户端完成。

提交头为Content-Type: application/json及Idempotency-Key: 16～80位字母、数字、下划线或短横线。相同稿件重试使用相同去重键；挑战过期可重新获取，但不要改变原稿。单次请求上限96KiB，每邮箱每日3份，每来源IP每日10份，待审容量500份，并有短时请求限流。内容指纹相同的稿件拒绝重复入库，接口不抓取外链、不收附件，不支持指定status。

回执与状态

状态包括pending、changes_requested、rejected、published、withdraw_requested、withdrawn、expired。只有审核发布后才会给出可访问的article_url。查询接口不返回原稿、姓名、邮箱、内部审核记录或其他人的队列信息。令牌不可放进URL参数。

处理请求JSON示例：{"type":"correction","message":"请说明需要核实、补充或更正的具体资料"}。type也可为privacy或withdraw。此通道每天最多5次请求，管理员可在后台答复；未刊发稿撤回后不能发布，已刊发稿撤回需管理员核对处理。

常见返回：400 JSON无效；403来源或HTTPS不允许；404回执无效；405方法不支持；413请求过大；415格式不支持；422字段、同意、挑战或重复校验未通过；429限流；503队列繁忙或容量已满。尊重Retry-After并退避，收到201或200后不要持续重复提交。

责任人确认后使用客户端

python opc-submit.py --file my-project.json --submit \
  --accept-agreement 2026-10-18.1 --authorized \
  --privacy-consent --hong-kong-storage-consent \
  --receipt private-receipt.json

客户端只使用Python标准库，不上传本地目录或自动执行稿件中的命令。默认只校对当前协议和打印检查结果；显式提交时才发送稿件及联系资料。