{"api_version":"1.0","purpose":"帮助用户查询化学数据并提交属于该用户的结构化反应","api_base_url":"https://huagongshe.com/api","openapi_url":"https://huagongshe.com/api/openapi.json","help_url":"https://huagongshe.com/guide","optional_skill_url":"https://huagongshe.com/skills/huagongshe-reaction-publisher/SKILL.md","authentication":"Authorization: Bearer <用户创建的 API Token>","navigation":[{"purpose":"查询化合物或反应","method":"GET","path":"/api/search"},{"purpose":"校验反应草稿","method":"POST","path":"/api/reactions/validate"},{"purpose":"发布已确认的反应","method":"POST","path":"/api/reactions"},{"purpose":"读取用户反应库","method":"GET","path":"/api/users/me/reactions"}],"workflow":["读取用户提供的网页、文档、图片或文本并保留来源证据","只整理明确事实；结构有歧义或必要字段缺失时向用户确认","生成结构化草稿并确认 visibility=public 或 private","调用 POST /api/reactions/validate","用户确认后携带唯一 Idempotency-Key 调用 POST /api/reactions","向用户返回 HRID、页面 URL、可见性和新建 HCID"],"rules":["本入口和 OpenAPI 即可完成接入；Skill 仅用于为支持技能的 AI 固定行为约束。","提交前应查询并核对参与物；系统最终仍会按标准结构匹配或创建 HCID。","不得编造 SMILES、来源、条件、收率或实验过程；未知值应省略。","至少提供一个反应物、一个产物和明确的 source_type。","公开提交前必须确认用户希望 visibility=public；否则使用 private。","正式提交必须发送唯一 Idempotency-Key，重试时复用同一个值。","先调用 POST /api/reactions/validate，再调用 POST /api/reactions。","API Token 当前只用于查询、验证和创建；编辑、可见性调整与删除由用户在网页完成。"],"source_types":{"self":"用户本人实验","doi":"必须提供 doi","patent":"必须提供 patent","url":"必须提供 source_url","database":"必须提供 source_citation","other":"必须提供 source_citation"},"operation_ids":["GET /api/search","GET /api/chemicals/{id}","GET /api/reactions/{id}","POST /api/reactions/validate","POST /api/reactions","GET /api/users/me/reactions"],"ownership":{"created_reaction":"直接归入 Token 所属用户的反应仓库","public":"可被所有人查询和关注","private":"仅创建者网页登录后可见","maintenance":"创建者可在网页编辑、切换可见性或删除"},"rate_limits":{"queries_per_minute":60,"structure_queries_per_minute":20,"reaction_writes_per_minute":10,"reaction_writes_per_day":200}}