接口使用 了解 API 接口的相关内容后，您可阅读以下开发文档来学习简道云中 API 接口相关内容： 应用接口 表单和数据接口 文件接口 流程接口 通讯录接口

简介 1.1 接口简介 表单接口包括： 表单字段查询接口V1 表单字段查询接口V2 表单字段查询接口V5 开发前，请仔细阅读 开发指南。 以下所有接口路径中的 app_id 和 entry_id 分别表示应用 ID 和该应用内的表单 ID，因此 app_id+entry_id 表示全局唯一的表单 ID，可以前往开放平台内的 API 文档进行查看。

文件API 2.1 获取文件上传凭证和上传地址接口 获取文件上传凭证和上传地址接口 接口版本说明： 接口版本 更新时间 版本说明 v1 2021.12.30 原始接口 v5 2022.10.28 在 v1 的基础上，接口请求频率由 5 次/秒提升至 20 次/秒； 参数 app_id 和 entry_id 放入 body，接口路由修改为 POST app/entry/file/get_upload_token

简介 数据接口也叫数据API，通过数据接口，可以实现数据的增、删、改、查等操作。 2. 接口类型 数据接口目前包括以下 7 个接口： 序号 接口名称 接口描述 1 查询单条数据接口 按照指定数据 ID 获取表单中的数据。 2 查询多条数据接口 该接口的返回数据，始终按照数据 ID 正序排列。 3 新建单条数据接口 在指定表单中添加一条数据。

接口列表 应用接口主要包括以下接口： 接口名称 释义 用户应用查询接口 仅获取 API Key 当中应用授权范围内的应用信息。 用户表单查询接口 获取当前应用下所有表单信息。

接口列表 流程接口主要包括以下接口： 接口名称 释义 获取单条流程表单数据的审批意见 该接口用来获取单条表单流程数据的审批意见。 查询流程实例信息 该接口用来查询流程实例信息。 结束流程实例 该接口用于结束当前流程实例。 流程待办查询 该接口用来获取当前用户待办信息。 流程待办提交 该接口用来提交流程待办。 流程待办回退 该接口用来回退流程待办。 流程待办转交 该接口用来转交流程待办。

简介 成员接口是可以对通讯录成员进行查询、添加、修改等一系列操作的接口。 开发前，请仔细阅读 开发指南（内含错误码对照表）。 2. 接口列表 成员接口主要包括以下接口： 接口名称 释义 获取成员信息接口 根据 username 获取指定成员的名称和部门编号。支持公共模式和集成模式。

简介 部门接口是可以对通讯录部门组织进行新增、删除、修改、查询等一系列操作的接口。 开发之前，请仔细阅读 开发指南（内含错误码对照表）。 2. 接口列表 部门接口主要包括以下接口： 接口名称 释义 （递归）获取部门成员接口 能够（递归）获取指定部门 id 下的所有成员。支持公共模式和集成模式。 （递归）获取部门列表接口 能够（递归）获取指定部门 id 的所有子部门。支持公共模式和集成模式。

简介 表单和数据接口包括表单接口和数据接口： 接口类型 接口文档 接口说明 表单接口 表单接口 可以获取指定表单的字段/字段信息。 数据接口 查询单条数据接口 按照指定数据 ID 获取表单中的数据。 查询多条数据接口 该接口的返回数据，始终按照数据 ID 正序排列。 新建单条数据接口 可以向指定的表单中添加单条数据。

本章内容： 成员接口 部门接口 角色接口 角色组接口 企业互联接口

简介 角色接口是可以对 通讯录 中的角色进行新增、删除、修改、查询等一系列操作的接口。 开发前，请仔细阅读 开发指南（内含错误码对照表）。 2. 接口列表 角色接口主要包括以下接口： 接口名称 释义 列出角色接口 将角色列出来。支持公共模式和集成模式。 创建一个自建角色 只能创建内部自建角色。支持公共模式和集成模式。 更新一个自建角色 对自建角色进行更新。

简介 角色组接口是可以对 通讯录 中的角色组进行新增、删除、更新、列出等一系列操作的接口。 开发前，请仔细阅读 开发指南（内含错误码对照表）。 2. 接口列表 角色组接口主要包括以下接口： 接口名称 释义 列出自建角色组 将角色组全部拉取出来。支持公共模式和集成模式。 创建自建角色组 通过接口新建角色组。支持公共模式和集成模式。 更新自建角色组 更新创建好的角色组信息。

2021-12-30 新增「文件接口」、「新建多条数据接口」以及「更新多条数据接口」。点击查看详情： 文件接口 新建多条数据接口 更新多条数据接口 2021-10-26 表单API 新增「表单字段查询接口V2」，V2 在 V1 的基础之上新增了系统字段及表单数据修改时间的获取。详细使用方式参见文档：表单&数据接口。

设置步骤 2.1 设置入口 1）登录 简道云账号，进入「企业管理 >> 管理工具 >> 企业设置」页面中。 2）在「企业安全 >> 单点登录」处，打开单点登录的开关，并点击「配置」按钮。 2.2 选择配置方式 进入配置单点登录详情页中，选择单点登录配置方式为「CAS」。如下所示： 2.3 设置Idp登录接口 Idp 登录接口，指的是通过开发人员部署所需的基础内容，允许用户登录系统的接口。

简介 1.1 接口简介 通过查询多条数据接口，可以一次查询表单中的多条数据。

设置步骤 2.1 设置入口 1）登录 简道云账号，进入「企业管理 >> 管理工具 >> 企业设置」页面中。 2）在「企业安全 >> 单点登录」处，打开单点登录的开关，并点击「配置」按钮。 2.2 选择配置方式 进入配置单点登录详情页中，选择单点登录配置方式为「自定义接口」。如下所示： 2.3 设置Idp登录接口 Idp 登录接口，指的是通过开发人员部署所需的基础内容，允许用户登录系统的接口。

接口调用 在指定表单中添加一条数据。

简介 企业互联接口支持对通讯录中 互联组织 中的企业及对接人进行列出，获取我连接的企业对接人的详细信息。 1）开发前，请仔细阅读 开发指南（内含错误码对照表）。 2）接口文档中的「我连接的企业」 =客体企业=外部部门。 2. 接口列表 企业互联接口主要包括以下接口： 接口名称 释义 列出我连接的企业 能够获取所有 外部部门 的列表。支持公共模式和集成模式。

简介 1.1 接口简介 通过查询单条数据接口，可以查询表单中的指定数据。

1.2 接口版本 接口版本 更新时间 版本说明 v1 2018.12.4 使用 _id 作为 id v2 2019.6.21 使用 username 作为 id v4 2022.6.30 返回值新增字段 type、status、integrate_id v5 2022.10.28 在 v4 的基础上，接口请求频率由 5 次/秒提升至 20 次/秒； 接口路由修改为 POST corp/user/create