用户&流程开放文档

2808 上次更新时间:2021-02-21 18:27:27

Document

注意

Base URL

https://api.pro.surongyun.cn/

接口请求类型

本文档所涉及到的所有接口的调用方法为 POST 类型,请求参数的类型为 Json 格式

身份验证问题

所有接口需要将 openApi 生成的 AuthCode 放到 header中完成身份的验证   
请求Header中添加的Authorization字段;配置Authorization字段的值为“Bearer + 半角空格 +AuthCode值”。
格式如下:

Authorization:Bearer AuthCode值

示例如下:

Authorization:Bearer 3F2504E04F8911D39A0C0305E82C3301

Curl示例:

curl --location --request POST 'https://xxx/openapi/form/smart/5f23be36e4b03ccc874f091a/query' \ --header 'Authorization: Bearer gqRZRzGm8Dw38IgQjabdQf2bSrjTUB4U' \ --header 'Content-Type: application/json' \ --data-raw '{ "phone":"18710841735", "pageSize":1 }'

身份验证错误返回示例

{ "timestamp": "2021-01-22T07:48:45.657+0000", "status": 401, //无权限 "error": "Unauthorized", "message": "illegal token,access denied", "path": "/openapi/form/smart/5f23be36e4b03ccc874f091a/query" }

请求接口方式错误返回示例,请求接口请使用 POST 方式

{ "timestamp": "2021-01-27T08:38:33.613+0000", "status": 405, "error": "Method Not Allowed", "message": "Request method 'GET' not supported", "path": "/openapi/instance/flow/filter/todo" }

服务返回

{ "code": 0, //状态码 非 0 则为错误返回 "msg": "success", //内容 错误时 会返回错误信息 "result": {} //返回的结果信息 }

节点类型说明

节点类型 节点说明
start 开始节点
approval 审批节点
provideInput 填写节点
cc 抄送节点
end 结束节点

节点状态说明

节点执行状态 状态说明
RUNNING 进行中
FINISH 已完成
REJECT 拒绝
END 结束节点已结束

表单状态说明

表单执行状态 状态说明
RUNNING 进行中
REJECT 拒绝
AGREE 已同意

按钮操作说明

originName 操作 说明
agree 同意
reject 拒绝
submit 通过/提交
forward 转交
revocation 撤回
repulse 驳回

错误码

错误码 说明
待补充

使用时间说明

在系统中返回时间的地方,返回的时间均为13位时间戳(精确到毫秒)请根据需求自行转换类型,传递给速融云的时间也请使用13位时间戳(精确到毫秒)。

名词解释

应用

在速融云中应用是最小逻辑单元,或者应用是你创建或创建的「系统」,你可以理解为手机上的一个个软件,如 微信、飞书、钉钉  等等都是应用。 一个 速融云应用通常由一个或多个有联系的表单、流程、仪表盘和数据协作组成
应用具有唯一标识 appId,查询应用信息或者应用下表单使用 appId

表单

速融云中,承载数据收集、展示的载体就是『表单』。
在日常工作中,在纸质时代制式表单的语义与我们的表单一样。 数据的格式填写、上报、汇总都是通过表单来实现。
表单有唯一标识formId,查询表单信息,使用formId

流程

表单数据提交后流转的方式。一个表单对应一个流程。
一个表单对应一套流程,查询表单的流程信息也使用 formId 来查询

节点

流程处理的每一步就是 1 个节点。一个流程包含多个节点。节点具有自己的 nodeId

instanceId

表单提交的一条数据,就是一个数据实例,对应一个唯一标识 instanceId

一、用户对接

1.新增用户

/openapi/org/user/add

请求参数

{ "thirdUserId":"333", //第三方用户的唯一标识 必填 "username":"用户名", //用户名称 必填 "userImage":"头像" //用户头像 选填 不传递头像,系统会使用系统生成的默认头像 }

响应参数

{ "code": 0, "msg": "success", "result": { "userId":"34" //速融云的用户 Id } }

2.删除用户

/openapi/org/user/remove

请求参数

{ "thirdUserId":"333" //必填 }

响应参数

{ "code": 0, "msg": "success", "result": null }

3.更新用户

/openapi/org/user/update

请求参数

{ "thirdUserId":"333", //第三方用户的唯一标识 必填 "username":"用户名", //用户名称 必填 "userImage":"头像" //用户头像 选填 }

响应参数

{ "code": 0, "msg": "success", "result": { "userId":"34" //速融云的用户 Id } }

4. 用户的列表

/openapi/org/user/list

请求参数

{}

响应参数

{ "code": 0, "msg": "success", "result": [ { "userId":"34", //速融云的用户 Id "thirdUserId":"333", //第三方用户的唯一标识 "username":"用户名", //用户名称 "userImage":"头像" //用户头像 } ] }

5. 用户的兑换

第三方用户兑换速融云用户 Id,返回对应的 key-value 结构,没有找到的不返回

/openapi/org/user/exchange

请求参数

{ "thirdUserIdList":["35","46","57"] //必填 不能为空数组 }

响应参数

{ "code": 0, "msg": "success", "result": { "35":"789", "46":"987", "57":"999" } }

二、流程设计

1.获取表单流程节点信息

/openapi/flow/node/list

请求参数

{ "formId":"5e0d67094f3e5f00071635b4" //必填 表单的 Id }

响应参数

{ "code": 0, "msg": "success", "result": [ { "nodeId":"当前节点 Id", "nodeType":"节点类型", //参考下面的节点类型说明 "previous":"前一个节点Id", "next":"下一个节点的 Id", "parent":"父节点的 Id", "nodeName":"节点名称", "chargePerson":{ "memberIdList":["34","35"], //团队成员 Id信息 "roleIdList":["12312312"], //角色