协会易开放接口

解决的问题

协会易开放接口适合把后台业务动作接入对话式机器人：用户用自然语言要求“建一张申报表”“把问卷绑到这张表”“推一篇新闻”或“看看待办”，系统需要把这些意图翻译成稳定的 HTTP 请求，并在多步骤里保留服务端返回的 id。资料重点不是泛化 API 包装，而是围绕表单、问卷、项目申报、新闻和流程待办给出一套可执行的集成约束。

技能如何工作

• 表单：调用 addForm 前先把字段结构按可读方式渲染给用户确认；成功后从 data 取 formId，若名称重复则使用 errmsg 中已有 formId，不要改名重试。
• 问卷 / 项目申报：问卷绑定传 id + formId；项目申报绑定传 decTitle + formId，两者路径和参数不能混用，且 formId 只能来自表单接口返回。
• 新闻：先用栏目列表取 categoryIds，再 pushArticle；正文必须完整，已推送稿件用 updateArticle 修正，文章 id 来自推送成功返回。
• 流程待办：列表用 applySubject，详情再拼 formAnswer / extra；audit 属于不可逆操作，需用户明确确认。

关键判断是成功与否只看 errno === 0，失败时用 errmsg 说明原因，不要假设资源已创建。

适用边界

适合龙虾机器人等已有对话上下文的自动化场景。注意 appKey 不应在聊天中完整复述，材料解析要满足授权要求，审批动作不能默认执行。