文档中心 > 办公协同接入

协同办公类应用接入方案

更新时间:2024/08/01 访问次数:57492

1、入驻流程

申请流程参考://open.taobao.com/businessDetail.htm?tagId=84

聚石塔入驻参考:http://cloud.tmall.com/solution/doc.htm?id=102126&catId=101756

2、系统流程

2.1、简介

应用加入卖家服务中心,供卖家订购使用OA协作软件。

2.2、业务场景

  1. 订购场景及流程设计,如图1-1所示:
  • 卖家在服务市场订购应用,卖家付款后,淘宝发送相关信息给开发者应用预设的URL,告知订购用户淘宝账号、团队名称,订购版本。
  • 开发者服务器,接收到信息,根据淘宝主账号、团队名称及订购金额,初始化该用户账户体系(手机号与邮箱号作绑定号,昵称作为用户名、初始密码),根据订购版本决定团队空间及人数上限。
  • 用户订购后,可以使用登录界面进行登录(注册的邮箱或者手机号+初始密码)开发者服务器。

说明:

  1. 应用预设的URL:开发者创建应用时填写的回调URL,在上面流程中用户点“立即使用”后页面就会跳转到这个URL,并且带有用户信息参数(淘宝昵称、订购版本等)
  2. 用户订购后还可以通过API来获取相关信息,具体参考:点击查看

订购流程图

  1. 线下用户注册登陆场景及流程设计,如图所示:

线下用户可以自己申请账号(必须要用手机号注册),申请加入已建立的淘宝团队,也可根据管理员发起邀请加入,该部分用户在开发者账户体系中加入电商标识,同时用户数据同步到openAccount

应用本身已有账号体系:

线下用户注册登录

应用还没有账号体系:

线下用户注册登录

  1. 用户信息修改场景及流程设计:
  • 修改密码、重置密码、用户绑定邮箱或者手机号:
    用户修改密码或重置密码时,判定其是否为电商用户,若为电商用户,修改的同时,进行数据同步到openAccount
        用户执行绑定后,判定其是否为电商用户,若为电商用户,数据同步到openAccount。

已有账号体系应用

  • 修改密码、重置密码、用户绑定邮箱或者手机号(没有自身账号体系):
    用户修改密码或重置密码,通过SDK唤起OpenAccount修改密码页面,进行数据同步到openAccount


3、账号同步方案

OpenAccount是阿里巴巴为开发者提供的独立账户注册、登录、管理的基础能力,能够帮助开发者降低开发成本,与阿里巴巴其他技术体系更好的集成。 OpenAccount提供的账号集成包括:新账号注册、开发者已有账号体系集成、第三方社交平台开放账号体系。并为以下服务提供账号支撑:IM、图片、社区、LBS、数据。

3.1、账号同步介绍

对于已有账号体系和账号数据的开发者以及希望在自己系统中独立存储一份账号数据的开发者需要进行账号数据的同步。OpenAccount支持开发者历史存量账号数据的导入、增量账号变化的双向同步。 同步接口使用TOP API规范,调用方式:http://baichuan.taobao.com/portal/doc?articleId=192。所有同步接口同保障幂等性,允许重试。 对于新开发的App可以选择不进行账号数据同步。

3.2、存量账号同步

若开发者已存在自己的账号体系且已积累了线上数据,需进行存量账号同步。 同步方法: 开发者选择新增账户量最小的时间点(建议停机进行同步)扫描所有的存量开发者用户,调用TOP接口taobao.open.account.create提交同步数据,并把调用返回的OpenAccountID写回到开发者账号数据库中,建立开发者 AccountID和OpenAccountID的映射关系。

注意:如果要使用OpenAccount提供的UI,那么在同步数据时mobile、type、status、login_pwd_encryption、login_pwd这几个参数是必需的;如果不想保存openAccountId可以设置下开发者AccountId。

3.3、账号变化同步

在存量账号同步完成后,若开发者需要。

账号数据变化

同步方式

调用接口

开发者账号新增

开发者立即调用TOP接口

taobao.open.account.create

开发者账号修改

开发者立即调用TOP接口

taobao.open.account.update

开发者账号删除

开发者立即调用TOP接口

taobao.open.account.delete

OpenAccount账号新增

开发者接收消息通知

参考消息通知文档

3.4、同步结果核对

为保障开发者和OpenAccount系统账户数据的一致性,建议定期(每日)自动对同步后的账户数据进行核对,评估是否有遗漏的同步。 同步核对由开发者主动发起,通过调用TOP接口的方式进行。 API接口:taobao.open.account.list

3.5、数据同步API

API

文档

说明

taobao.open.account.create

点击查看

导入数据

taobao.open.account.update

点击查看

更新数据

taobao.open.account.delete

点击查看

删除数据

taobao.open.account.list

点击查看

查询数据

taobao.open.account.search

点击查看

搜索数据

3.6、账号登录验证 

为了保证登录账号的真实性和有效性,账号在客户端登录后通过getSession.getAuthorizationCode()会返回authcode,我们可以在服务端验证。我们提供两种方式:

 

1、通过我们提供的服务端API来验证

API

文档

说明

taobao.open.account.token.validate

点击查看

token验证

taobao.open.account.token.apply

点击查看

token申请

2、直接通过服务端代码实现

以下是伪代码:

以下是java示例:

执行结果:

qMLYZspBM1rF79ZNoFRzUwzgS8Z5jdVq1mlVCDuTDoNZFKvCxLNRR9GrGSabZ1uES54ZTjnzXRP6TAkY3guuzXNJse5TdqiB0XyLxsaAKZagBXh+Q4IAB7xbR5LQ1xc+aszs/8roP9H7XLkPMADHs1jDKlNaVFPxWqAn67kZs1X8jWzOf9XNacCdCSvdXNAN

    TokenInfo [timestamp=1433734274168, isvAccountId=xxxx, openAccountId=1, loginStateExpireIn=3600, uuid=d6f8d5f3-2586-4cb9-bd03-007c5bb32f3c]

示例代码下载:点击下载

4、客户端相关内容

客户端集成:提供账号注册、登录、短信验证等服务,支持UI定制。AndroidiOSUI定制(Android)UI定制(iOS)

OpenIM免登:OpenAccount的账号支持直接登录OpenIM。AndroidiOS

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部