2018-06-21更新日志

简道云提供了表单API和数据API,用于给具备编程能力的用户提供方法集成外部系统。

规则

  • API的统一访问地址为:https://www.jiandaoyun.com/api/v1
  • 所有 API 请求都必须通过HTTPS进行身份验证和发起
  • 统一采用 POST 请求的形式
  • 数据传输编码为 UTF-8
  • 所有数据均为 JSON 格式

频率限制

最多接受请求:5次/秒

鉴权方式

简道云使用基于简单令牌的身份验证(在 “账户中心” 生成或管理您的 API Key )。

生成方式:账户中心>>账号设置>>API Key

对于生成的API Key 还可以进行重置和删除。

API Key右侧的「API文档」是专门根据当前表单的配置生成的。

表单API

表单API提供了「表单字段查询接口」

通过表单API可以获取指定表单的字段信息,除分割线字段和关联查询字段以外。 注意:表单字段一旦添加,则以widget为前缀的字段ID将不再会发生变更。如果您删除/添加字段或者修改字段标题,则该文档里所对应的表单字段的其他信息也会相应更改。

数据API

数据API所提供的接口有以下五种:

(1)查询多条数据接口

(2)查询单条数据接口

通过API接口查询到的数据支持过滤,可通过filter参数进行数据过滤。 查询到的数据内容中,除了表单字段以外,还有一些系统字段。

系统字段有:appId、entryId、数据ID、扩展字段、提交时间、提交人、修改时间、修改人、流程状态(仅流程表单)

(3)新建单条数据接口

使用该接口可以在指定表单中添加一条数据。 目前系统字段和以下所列举的字段不支持添加和修改数据: 分割线、图片、附件、手写签名、成员单选、成员多选、部门单选、部门多选、关联数据、关联查询

(4)修改单条数据接口

按照指定数据ID修改表单中的数据。 使用API修改数据时,会触发的事件有聚合表计算&校验、数据操作日志、数据量统计。不进行重复值校验、必填校验等。

(5)删除单条数据接口

按照指定数据ID从表单中删除数据。

有了以上数据接口,我们可以通过表单API和数据API将第三方新增/更新的数据写入简道云,也可以通过第三方查询简道云的数据,方便了团队成员处理多方系统的数据。

具体使用帮助可以参考帮助文档「表单&数据API」

数据接口目前仅提供给定制版用户,如有功能使用需求可以联系我们。

在线咨询:商务咨询

商务电话:400-111-0890

定制意向:意向填写

Copyright(C)2023 HFBangFu Inc. All Rights Reserved 皖ICP备12017563号-5