开发前必读
概述
开发者使用指南
开发者使用流程
通信说明
开发者工具
更新日志
基础能力接口
获取token接口
外部系统单点登录
单点登录使用说明
获取单点登录用户信息
通讯录管理
获取部门列表
新增部门
修改部门
删除部门
新增用户
修改用户
删除用户
获取用户列表
通讯录变更同步
获取标签信息
新增标签
修改标签
删除标签
获取标签成员列表
添加标签成员
删除标签成员
按部门查询标签
按用户查询标签
离职用户
获取离职信息
用户复职
获取自定列表信息
第三方消息推送
推送文本消息
推送图文消息
推送消息附录
统一消息推送(回调)
图片附件上传
图片附件下载
图片附件单个下载
图片附件批量下载
应用数据接口
表单流程/七巧
新增表单
获取表单模板信息
推送数据
修改表单数据
删除表单数据
数据源
数据回调
导出表单流程数据
获取填写情况详细数据(新)
通过ID获取填写详细数据(新)
流程干预
获取填写情况详细数据(旧)
通过ID获取填写详细数据(旧)
获取应用填写详细数据(待办、已办等)
发票识别接口
发票验真接口
附录
考勤打卡
获取考勤规则列表
获取考勤详细信息
获取考勤日报信息
注册考勤服务
新增虚拟考勤机
删除虚拟考勤机
考勤机打卡
获取考勤排班明细
获取考勤异常申诉记录
请假出差
获取请假信息列表
获取请假类型列表
假期管理
获取请假详情信息
新闻公告
获取新闻动态类型
新增新闻动态
获取新闻列表
获取新闻详情
获取个人新闻列表
费控报销
获取报销信息列表
获取成本中心信息列表
导入成本中心
获取预算明细
获取发票信息列表
获取借款信息列表
获取用户可见范围内成本中心
获取用户可见范围内科目
获取超额预算
费控预算操作
企业用车
获取车辆申请列表
任务分派
获取任务分派信息列表
获取任务类型信息接口
新建任务接口
移动CRM
获取客户信息列表
获取客户字段
新增客户
更新客户
获取客户详情
获取客户类别
获取所有公海池
获取所有行业信息
获取联系人信息列表
获取联系人字段
新增联系人
更新联系人
获取联系人详情
获取商机信息列表
获取商机字段
新增商机
更新商机
获取商机详情
获取商机阶段或商机类型
修改商机阶段
获取拜访信息列表
获取合同信息列表
获取合同字段
新增合同
更新合同
获取合同详情
获取公海池客户信息列表
获取公海池客户详情
培训考试
获取考试成绩列表
获取考试统计信息列表
获取考试人员明细
获取学习统计信息列表
获取个人学习档案信息列表
获取课程统计信息列表
获取课程人员明细
获取个人学分明细
获取讲师信息列表
获取题库试题明细
新增题库试题
删除题库试题
移动外勤
获取签到信息列表
会议管家
获取会议详情
获取会议纪要详情
获取会议室详情
获取区域列表
获取会议室列表
获取会议详情列表

开发者使用流程

开发说明

1、获取开发者权限

企业购买数据接口服务后,系统自动开通API使用权限。


2、配置开发者信息

开发者信息在道一云管理后台【设置-开发者管理】栏目中进行配置,可配置单点登录URL、白名单IP,可信任域名、凭证密钥、回调地址。


  • · 开发者ID(uid)即 developerId
  • · 单点登录URL:单点登录可以实现从道一云管理后台电单点登录到其他管理系统。
  •         1)基于道一云的项目已实现单点登录业务,直接配置域名即可使用
  •         2)非道一云的第三方,需自行实现单点登录业务
  •         3)不需使用可不填写;单点域名配置设后,在道一云后台的“协同”类目中会显示单点登录菜单

        URL示例:http://xxx.com/wxqyh/portal/weixin/weixinclientAction!loginQiwei.action

· 白名单IP:调用道一云API的服务器IP,多个服务器使用英文分号分隔,只要用到API接口服务,就必须配置此项。

· 可信任域名:第三方应用页面跳转到道一云时,需要验证第三方应用的URL域名;如暂无此应用场景可不设置。

· 凭证密钥(developerKey):可以由系统生成(随机生成),也可以自己配置;不超过48个字符,只要用到API接口服务,就必须配置此项。

· 回调地址:全局回调地址,用于接口回调。




3、获取token

token是企业号的全局唯一标识,调用任何接口都需携带token。

token需要用developerId和developerKey(详见配置开发者信息)来换取,不同的developerKey会返回不同的token。

点击查看获取token方式: https://qy.do1.com.cn/qwy/api/get-token.html

4、接口调用

根据业务需求调用相应功能接口,见“应用数据接口”。