# ZICQ submission spec (machine-readable) A field-level description of the submission channel, for AI agents and automation tools. Important: the submission endpoint requires a signed-in session cookie plus its CSRF token; anonymous requests are rejected (403 CSRF failure, 401 not signed in). Human-usable entry points: - https://zicq.com/en/submit (submission guide) - https://zicq.com/en/projects (published projects) - https://zicq.com/en/news (published articles) ## Submission endpoint POST https://zicq.com/api/submissions Content-Type: application/json Requires a signed-in session cookie; otherwise 401. The request body accepts no author fields — the byline always comes from the session user. Session cookie name: zicq_session (or __Host-zicq_session when SecureCookie is enabled). CSRF: send the data.csrfToken value returned by GET /api/auth/me in the X-CSRF-Token header. A missing token or a cross-origin write request returns 403. ## Fields | field | type | required | description | | --- | --- | --- | --- | | type | string | yes | project (recommend a project) or article (submit an article) | | title | string | yes | project name / article title | | category | string | no | category; empty means the default one | | summaryOrDesc | string | yes | project description / article summary | | contentOrUrl | string | required for article | article body (Markdown); for a project, the product URL | | githubUrl | string | one of the two for project | GitHub repository URL | | demoUrl | string | one of the two for project | live product URL | | tags | string | no | comma-separated tags | | titleEn / summaryEn / contentEn | string | no | English version; translated automatically when left empty | Note: category values are the literal whitelist strings (Chinese) — submit them verbatim. A translated category is rejected with a 422 validation error. ## Project categories (category) - AI 应用 / 智能体 - 创意与多模态作品 - 实战工作流 / 案例 - AI / 大模型 - 开发者工具 - 基础设施 - Web3 - 前端 / 移动端 ## Article categories (category) - AI 前沿 - 开源风向标 - 技术深度 - 行业动态 ## Example (project recommendation) ```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" }' ``` ## Review rules - Only a signed-in account is required: no WeChat verification, no invitation code, no payment. - An AI review runs automatically after submission (quality score, authenticity, category and tag suggestions), and the bilingual version is completed automatically. - Approved content is published automatically: projects enter the showcase space, articles are compiled into the news channel. - Rejections come with a reason; borderline cases go to a human reviewer. - Advertising, traffic-farming, empty shells, and content unrelated to AI or open source are stopped outright.