UDN-企业互联网技术人气社区

板块导航

浏览  : 2250
回复  : 1

[企业空间] 企业空间开放平台接口汇总

[复制链接]
瞌睡虫的头像 楼主
发表于 2017-1-17 11:34:54 | 显示全部楼层 |阅读模式
  随着企业空间用户越来越多,企业空间自带应用可能不能满足部分客户的需求。

V`K@G9RZM`%S6D~(9NIKV(U.png



  这时候需要企业自建应用,在“应用管理”界面我们即可以看到添加企业自建轻应用的入口:

N6K1LB)23_4VV~0K}4UWRCL.png



  自建轻应用是如何实现自动登录的?能否调用空间相关业务?企业空间开放平台即可解决此问题。

`1$(VPH%5`_M05HPGEAVBNY.png



  先上张图,看看企业空间开放平台目前已有的接口:

  获取开放平台接口访问凭证

  要调用开放平台的接口,需要先获取到接口的访问凭证,其他接口依赖这个接口返回的凭证信息(其他接口参数中需携带返回的凭证数据)

  参考文档:获取access_token

  此接口需要的参数是appid、secret。可以在空间后台获取到:

6HHSBC_JMI1Z$O{OC_})]FK.png



  在空间管理后台添加应用时,可看到CorpId、CorpSecret参数;这两个参数就是获取访问凭证的appid和secret了。获取到的访问凭证有一定时间期限(目前默认是7200秒),在凭证过期前,轻应用后台重新调用此接口以续期。

  轻应用与空间的用户和组织架构同步

  在企业空间应用中心的轻应用很重要的一个需求是,在轻应用后台用户与组织架构数据与空间保持一致。

  对于入驻的大中型企业来讲,一般存在企业HR系统(或企业用户中心),轻应用后台完全可以使用HR系统中的用户和组织架构信息。那么,数据同步问题就变成了:

  1.如何保持HR系统中用户以及组织架构数据与企业空间同步?

  2.怎么关联企业空间的用户与组织架构数据与HR系统中对应的数据?

  解决这两个问题就要依靠开放平台对外的新增部门和新增用户的接口了,这两个接口都能返回在空间新增的部门或用户ID数据;HR系统就可以依据返回的ID绑定企业空间账号或组织和用户中心的数据了。

  由于部门和用户都有增删该查接口,现在系统说一下这些接口的调用时机:

  新增部门:HR系统(或用户中心)新增部门时,可调用此接口,将组织架构同步创建到企业空间中。

  相关接口文档:创建组织结构

  修改部门:HR系统(或用户中心)修改部门信息时,将最新信息同步到企业空间中。

  相关接口文档:修改组织结构

  删除部门:HR系统(或用户中心)删除部门信息时。

  相关接口文档:删除组织结构

  新增用户:HR系统(或用户中心)录入新入职员工时,可调用此接口,这样新入职的员工马上可以使用企业空间app了。

  相关接口文档:创建用户

  修改用户:HR系统(或用户中心)修改员工信息时,将最新信息同步到企业空间中。

  相关接口文档:修改用户

  停用用户:员工离职时,在HR系统(或用户中心)中录入离职信息时,可调用此接口,这样对应的用户就不能再使用企业空间进入到对应的企业了。

  相关接口文档:停用用户

  我们的轻应用直接使用HR系统(或用户中心)即可,在企业空间点击轻应用图标时,轻应用后台可以通过一定途径(后面要讲的免登API)获取到当前用户的企业空间用户ID,由于同步时已经关联了企业空间用户ID和用户中心用户ID,所以轻应用后台能够定位当前用户在用户中心的用户信息了,轻应用后台也就能基于用户信息进行对相关业务进行权限管控了。

  不排除存在轻应用直接使用企业空间的组织架构和用户信息的情况,也就是信息同步是从空间同步到轻应用后台的,这种情况下可以使用相关的查询接口了。对于组织架构,我们提供了查询子部门的接口,如果层级结构比较深,需要轻应用后台一级级获取。对于用户信息,建议定期使用获取最新修改用户资料接口,差量获取相关信息。

  相关接口文档:获取组织结构    获取最新修改资料用户

  企业空间业务接口

  目前开放平台暴露的企业空间业务接口不是很多,后续会开放出更多的业务接口出来。目前已开放的能力包含发送通知、发送微邮、上传附件、IM能力。

  如果轻应用后台操作需要触发发送通知知会到对应人员,可使用发送通知接口了。这样被通知人员手机端可以显示通知消息。

  同样如果轻应用在业务处理过程中需要触发发送微邮给对应人员,则可调用发送微邮的接口了。其他的业务接口类似,这里不再详述。

  具体文档可以看开放平台官网文档中心相关文档:企业空间开放平台

  免登服务

  无论是用户在企业空间app上点击应用图标进入轻应用还是在企业空间web上点击轻应用图标进入轻应用的,轻应用都能通过免登服务判断当前登录用户。具体流程如下图所示:

  其中较关键的环节是轻应用后台获取到code之后,调用开放平台依据code获取当前用户信息:

  相关接口位置:用户授权第三方验证

  此code只能消费一次,消费完了就不能再次使用了。当然,调用此接口之前需要先获取接口访问凭证,这样就保证了数据安全性了。

_CT0_4Q]R[I{QQV0@KM60MC.png

相关帖子

发表于 2017-9-6 11:37:40 | 显示全部楼层
楼主,您好,还有更多关于这方面的文档么?能否发我学习下,最近在了解用友移动端的开发,求赐教,谢谢!!另,您如果方便的话,可否将文档发到我邮箱(751916620@qq.com)?谢谢啦!
使用道具 举报

回复

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关于我们
联系我们
  • 电话:010-86393388
  • 邮件:udn@yonyou.com
  • 地址:北京市海淀区北清路68号
移动客户端下载
关注我们
  • 微信公众号:yonyouudn
  • 扫描右侧二维码关注我们
  • 专注企业互联网的技术社区
版权所有:用友网络科技股份有限公司82041 京ICP备05007539号-11 京公网网备安1101080209224 Powered by Discuz!
快速回复 返回列表 返回顶部