私有云账户对接流程.pdf

第三方私有云账户对接流程 前言 萤石开平团队对多家第三方应用接入方的案例进行调研，反复研究后，整理出一份基本涵盖第三方开 发者接入的流程文档，后续若有更新将会以系统公告的形式告知所有开发者团队。 请各位注意，账户对接的最终目的是第三方应用能拿到用户在萤石云平台授权过的认证信息（即用户 accessToken ）.能成功获取用户accessToken 的前提是第三方应用中的用户在萤石平台已经创建了相应的 萤石账户，并且此萤石账户与用户的手机号码绑定。 目前开平为第三方提供了两种获取用户accessToken 对接模式。 注：AccessToekn 的有限期为：7 天。 一 模式一：使用萤石标准OAuth 协议 使用萤石标准OAuth 协议，开发量比较小，第三方应用直接使用萤石的登陆、注册页面，对于没有账 号体系或没有后台服务的应用优先可以采用这种对接模式。 具体实现，可以参考各个DEMO 中的实现方式，使用萤石登陆页面登陆成功后，客户端SDK 会返回 AccessToken 给第三方应用。 第三方可通过拿到的accessToken,调用萤石平台获取用户基本信息接口得到用户的基本信息，基本信 息中包括返回一个萤石用户唯一标示id （ysid ）,第三方可将此ysid 与自己平台的用户进行绑定。 OAuth 错误码集合如下： 错误码 含义 1001 萤石账号不存在 1002 密码错误 1003 验证码错误 1004 用户被冻结 1005 需要短信验证码 1007 参数有误 1008 无权限 1010 服务暂停 1014 应用不存在 1015 第三方应用未通过审核 二 模式二：私有云对接授权 私有云直接调用开平后台接口获取用户的AccessToken.若私有云用户账号已经与萤石账号绑定过，那 么就会跳过流程一，直接进入流程二获取用户AccessToken.但是如果没有绑定过，调用获取AccessToken 的接口会返回“10011”错误码，则需要进行流程一的绑定流程。 流程一：私有云账户没有绑定过萤石账号，那么需要进行私有云用户账号与萤石账号绑定的过程 流程二：私有云用户账户已经绑定萤石账号，私有云后台直接调用开平接口获取用户AccessToken 详见以下流程图： 流程一 第三方APP 私有云 开平SDK 萤石云开平 获取用户acToken 调用开平后台接口，获取acToken （传参： userid,手机号码）注1 判断此用户未绑定萤石账号 返回未绑定的结果(返回错误代码10011) 组建获取短信签名字符传(注2) 返回签名字符串 调用开平SDK短信验证接口(传参：签名字符串）