功能类别 开发文档 API API 开发文档 Webhook Webhook 开发文档 单点登录 单点登录配置手册 前端事件 前端事件配置手册 插件管理 插件使用手册

申请试用 标准版不包含 API 及 Webhook 功能，企业版及以上的用户可直接体验 API 及 Webhook 功能，无需额外开通。

点击申请试用 - API & Webhook（价格咨询 / 功能测试 / 售前支持） 点击在线咨询

接口变动简介 Webhook 2021-03-31 00:00:00 后创建的 Webhook 在推送数据时，数据结构中新增子表单数据 ID； 2021-03-31 00:00:00 前创建的 Webhook 推送的数据不发生变化（不过后续也有计划对这部分 Webhook 进行改造，请各位用户尽早调整） API API 查询单条数据接口新增 v2 版本，v2 版本返回数据新增子表单数据 ID API

本节主题：4.2 服务端部署案例讲解 课程讲师：Charlie 观看地址：点我进入 1 本节要点 上期作业讲解 服务端部署实例（定时框架） 服务端部署案例（前端事件） 服务端部署案例（Webhook） 2 课前准备 无 3 课程内容 3.1 上期作业讲解 （演示） 3.2 后端应用实例（定时框架） import json from apscheduler.schedulers.blocking import

涉及接口如下： 新建单条数据 修改单条数据 查询单条数据 查询多条数据 注：本次更新后，新建 Webhook 推送的数据将使用 V4 数据结构，此改动会导致使用老 API 新 Webhook，或新 API 老 Webhook 时, 推送的结构和接口返回值的结构不一致。如果使用新 API 或 Webhook，需要把两者一起更新，同步使用新 API 及 Webhook。

代码示例 简道云为您提供了 Webhook server 多语言 调用示例，您可通过参考以下代码示例完成开发： c#：示例代码 go：示例代码 java：示例代码 node：示例代码 php：示例代码 python：示例代码 ruby：示例代码 4. 注意事项 1）webhook推送错误说明 接收到推送后需要返回给简道云 2xx 表示推送接收成功。

详细设置可参考 Webhook-数据推送。 注：「流程变更时推送」功能仅流程表单可见、可用。

2.2 记录参数 1）消息推送添加成功后，将消息推送中的 webhook 地址复制并保存。 2）如果没有及时进行复制和保存备份，或在插件配置过程中出现失败情况，需要重新查看 webhook 地址，可以从企业微信群中进行查看。 注：在一个群里只需要添加一个消息推送，多张表单的数据都可以由同一个群消息机器人来推。 3. 插件使用 插件使用可先安装：企业微信群机器人配套模板表单。

微信增强中的字段支持API&webhook 微信增强中的三个字段支持API和webhook，分别是： 微信OpenID 用户昵称 用户性别 支持的场景有： 查询多条数据接口 查询单条数据接口 webhook数据推送 2.

涉及接口如下： 新建单条数据 修改单条数据 查询单条数据 查询多条数据 注：本次更新后，新建 Webhook 推送的数据将使用 V4 数据结构，此改动会导致使用老 API 新 Webhook，或新 API 老 Webhook 时, 推送的结构和接口返回值的结构不一致。如果使用新 API 或 Webhook，需要把两者一起更新，同步使用新 API 及 Webhook。

（二）API和webhook备份数据 过去： 通过导出 Excel 进行数据备份，操作机械化、辗转费时。 现在： API 将简道云直接插入公司数据库，数据可在桥科院自研的信息平台上统一展示；再通过 webhook 把数据推送到服务器做备份。

因此厚一学堂为了满足“既想使用简道云的仪表盘，又想使用钉钉的考勤”的管理需求，通过简道云 Webhook+API，将简道云与钉钉的考勤状态、工作通知、审批结果（扫码自助打印）功能进行打通，实现了对外可通过短信提醒让家长了解学生在校动态。 三、技术架构 简道云 Webhook+API，打通钉钉考勤-审批-通知管理流程 以学生请假为例： 学生在钉钉工作台提交请假申请。

变动简介： Webhook 2021-03-31 00:00:00 后创建的 Webhook 在推送数据时，数据结构中新增子表单数据ID； 2021-03-31 00:00:00 前创建的 Webhook 推送的数据不发生变化（不过后续也有计划对这部分 Webhook 进行改造，请各位用户尽早调整） API API 查询单条数据接口新增 v2 版本，v2 版本返回数据新增子表单数据 ID API 查询多条数据接口新增

通过简道云 API 及 Webhook 功能，可以对接简道云和外部的其他系统、产品，打通二者间的业务与数据，消除数据孤岛！ 我们为您推荐了关于 API & Webhook 的学习内容，点击下方链接来学习吧： API开发指南 表单&数据接口 通讯录接口 webhook开发指南 数据推送

如下图所示，CRM 表单发布时，支持选择外部组织及其成员： 2.5 CRM支持Webhook数据推送 CRM 中的数据支持通过 Webhook 推送到其他平台。编辑 CRM 中需要推送数据的表单，在「扩展功能>>数据推送」处设置数据推送，设置方式同简道云中的 Webhook 推送设置。如下图所示： 3.

内容设置： 设置项 释义 备注 推送地址 【2.2 步骤】中飞书群机器人的 webhook 地址 密钥 【2.2 步骤】中飞书群机器人的签名校验密钥 消息内容 可以自定义编辑文本，也可以点击编辑框右侧的【+】插入表单字段 消息@成员 可以选择简道云组织架构中的成员，必须是飞书集成模式的简道云账号设置才有效 即简道云中的成员与飞书中的成员相匹配，且该成员在消息推送的群内。

= get_signature(nonce, payload, 'test-secret', timestamp): return 'fail', 401 简道云webhook推送错误说明 接收到推送后需要返回给简道云2xx表示推送接收成功。其他的返回结果则为返回信息错误，用户可以根据HTTP状态码自行定义推送错误的情况给简道云的返回码，简道云接受后，可在推送日志中显示出。

数据对接 通过简道云 API 及 Webhook 功能，企业可以实现与其他外部系统的对接，打通两者间的数据和业务。 API： 提供应用、表单、数据、文件、工作流、通讯录及 CRM 接口。 Webhook：是简道云提供的一种回调机制，可实现当简道云中有数据提交/修改/删除/恢复/表单结构变化时，向外部服务器推送相应的数据/信息。 4.

2.4 其他接口调整 调整 API 和 webhook 中「成员单选」、「成员多选」、「提交人」、「修改人」、「删除人」对应的返回结构，新增 status 属性。参考文档表单&数据接口中的「控件与数据类型对照表」。 status 属性分别对应的逻辑为： -1 表示离职 0 表示未加入 1 表示已加入 3.