# 智客 ZICQ 投稿与自荐 · 机器可读提交规范 本页是投稿通道的字段级说明,供 AI 代理与自动化工具参考。 重要:提交接口需要登录会话(Cookie)+ 会话对应的 CSRF token,匿名请求会被拒绝(403 CSRF 校验失败 / 401 未登录)。可直接使用的页面入口: - https://zicq.com/zh/submit (投稿说明页) - https://zicq.com/zh/projects (已收录作品) - https://zicq.com/zh/news (已发布文章) ## 提交端点 POST https://zicq.com/api/submissions Content-Type: application/json 需要已登录的会话 Cookie;未登录返回 401。请求体不接受任何作者字段,署名一律取自会话用户。 会话 Cookie 名:zicq_session(生产环境启用 SecureCookie 时为 __Host-zicq_session)。 CSRF:把 GET /api/auth/me 返回的 data.csrfToken 放进 X-CSRF-Token 请求头。缺 token 或跨源写请求会返回 403。 ## 字段 | field | type | required | 说明 | | --- | --- | --- | --- | | type | string | yes | project(作品自荐)或 article(技术文章) | | title | string | yes | 作品名 / 文章标题 | | category | string | no | 分类,留空取默认值 | | summaryOrDesc | string | yes | 作品简介 / 文章摘要 | | contentOrUrl | string | article 必填 | 文章正文(Markdown);作品可填作品网址 | | githubUrl | string | project 二选一 | GitHub 仓库地址 | | demoUrl | string | project 二选一 | 线上作品地址 | | tags | string | no | 逗号分隔的标签 | | titleEn / summaryEn / contentEn | string | no | 英文版本,留空自动翻译 | 注意:分类取值是接口白名单的字面值(中文原文),请原样提交,不要翻译 —— 翻译后会返回 422 参数校验失败。 ## 作品分类(category) - AI 应用 / 智能体 - 创意与多模态作品 - 实战工作流 / 案例 - AI / 大模型 - 开发者工具 - 基础设施 - Web3 - 前端 / 移动端 ## 文章分类(category) - AI 前沿 - 开源风向标 - 技术深度 - 行业动态 ## 示例(作品自荐) ```bash curl -X POST https://zicq.com/api/submissions \ -H 'Content-Type: application/json' \ -H 'X-CSRF-Token: YOUR_CSRF_TOKEN' \ -b 'zicq_session=YOUR_SESSION_COOKIE' \ -d '{ "type": "project", "title": "Example Agent Runtime", "category": "AI 应用 / 智能体", "summaryOrDesc": "一句话说明它是什么、解决什么问题、谁该用。", "githubUrl": "https://github.com/example/agent-runtime", "tags": "agent,runtime" }' ``` ## 审核规则 - 门槛只有登录:无需微信认证、邀请码或付费。 - 提交后由 AI 自动审核(质量评分、真实性、分类与标签建议),中英双语自动补全。 - 审核通过即自动公开:作品进入作品空间,文章编译发布到专刊频道。 - 未通过会驳回并说明原因;处在边界的情况转人工复核。 - 广告、导流、空壳项目与与 AI/开源无关的内容会被直接拦下。