QB-GF-003-2003 飞信客户端URL单点登录访问手机邮箱页面
2. 接口消息
消息名 SSOLoginMailReq SSOLoginMailResp 消息类型 Request Response 消息描述 单点登录手机邮箱URL 手机邮箱URL访问响应 消息方向 飞信客户端?邮箱平台 邮箱平台? 飞信客户端 3. 接口字段定义:
SSOLoginMailReq消息字段描述:
字段名 Token 重要性 必须 类型 说明 String SSOLoginMailResp消息字段描述:
字段名 ResultCode 重要性 必须 integer 类型 说明 返回值:0成功 其他参考5.8返回值定义
附录B 业务流程参考
为读者能够更好的理解本规范定义的VGOP能力互通调用类接口所涉及的流程和数据,本附录以飞信平台和手机邮箱互通场景为例,描述了飞信和手机邮箱之间的互通流程,以及流程中涉及的接口。这些接口在“VGOP能力互通调用接口”章节中和“附录A、飞信和手机邮箱能力互通相关接口参考”中有描述。
B.1 用户设置互通流程
B.1.1 用户互通设置流程
流程概述:用户由飞信平台发起互通设置请求,由VGOP和手机邮箱完成互通设置后,再通过飞信返回给用户互通设置结果。
10
QB-GF-003-2003 手手手手VGOP手手手手1 手手手手手手手手2 手手手手手手手手3 手手手手手手手手手手4 手手手手手手手手手VGOP-R2.1-015 手手手手手手手手6. 手手手手手手手手手手8 手手手手手手手手手手手手手手手手7. 手手手手手手手手VGOP-R2.1-039 手手手手手手手手10 手手手手手手手手手手手手手手手手11 手手手手手手手手手手12. 手手手手手手手手手手13 手手手手手手手手FETION-MEM-R2.4-01
流程说明:
1. 用户在飞信上发起飞信与手机邮箱的互通设置请求,并带飞信号作为参数; 2. 飞信平台向VGOP转发互通设置请求;
3. VGOP进行互通设置鉴权,检查用户是否具有飞信与手机邮箱二个平台的订购关系,以及检查订购
关系是否支持此互通设置; 4. VGOP生成互通设置;
5. VGOP向手机邮箱同步互通设置; 6. 手机邮箱保存用户的互通设置信息; 7. 手机邮箱返回互通设置同步结果;
8. VGOP向飞信平台返回互通设置结果,并同步设置信息;
9. 飞信平台向手机邮箱发送绑定查询邮箱别名请求;
10. 手机邮箱检查用户是否设置别名,如果有则直接返回别名,否则把传过来的飞信号设置为默认的别名;
11. 手机邮箱向飞信平台返回绑定查询别名结果 12. 飞信平台保存互通设置信息;
13. 飞信平台向用户返回互通设置结果
11
QB-GF-003-2003 B.1.2 用户取消互通设置流程
流程概述:用户由飞信平台发起解除绑定请求,由VGOP和手机邮箱完成不能绑定关系解除后,再通过飞信返回给用户解除绑定结果。
手手手手VGOP手手手手1 手手手手手手手手手手2 手手手手手手手手3 手手手手手手5 手手手手手手手手VGOP-R2.1-024 手手手手手手手手6 手手手手手手手手7 手手手手手手手手8 手手手手手手手手9 手手手手手手手手VGOP-R2.1-03
流程说明:
1. 用户在飞信上发起取消互通设置请求; 2. 飞信平台转发取消互通设置请求; 3. VGOP执行取消互通设置;
4. VGOP同步互通设置信息给手机邮箱; 5. 手机邮箱保存新的互通设置信息;
6. 手机邮箱返回同步互通设置结果;
7. VGOP向飞信平台返回取消互通设置应答结果; 8. 飞信平台保存新的互通设置信息;
9. 飞信平台返回取消互通设置应答结果给用户;
B.2 查询未读邮件数流程
B.2.1 方案A:控制流和业务流分离查询方案(推荐方案)
流程概述:飞信平台通过VGOP的能力互通鉴权后拿到token,飞信客户端携带token直接向手机邮箱平台查询未读邮件数。遵循VGOP控制流和业务流分离原则。
12
QB-GF-003-2003 手手手手A.1 手手手手手手手手VGOP手手手手A.2 手手手手手手VGOP-R2.2-01A.3 手手手手手手A.4 手手tokenA.5 手手手手手手手A.6 手手手手手手FETION-MEM-R2.5-01
流程说明:
A.1. 飞信平台向VGOP发送能力互通鉴权请求
A.2. VGOP进行业务互通鉴权,确定飞信平台和手机邮箱之间的互通关系; A.3. VGOP进行用户互通鉴权,确定该用户使用飞信和邮箱互通业务; A.4. VGOP向飞信平台返回应答,携带token
A.5. 飞信平台向手机邮箱平台发起查询请求,携带token; A.6. 手机邮箱平台根据用户标识和token返回查询应答结果
B.2.2 方案B:控制流和业务流不分离查询方案
流程概述:飞信平台向手机邮箱平台发起查询未读邮件数请求,执行此动作过程中VGOP进行互通鉴权。
13
QB-GF-003-2003 手手手手B.1 手手手手手手手手手VGOP手手手手B.2 手手手手手手FETION-MEM-R2.4-02B.3 手手手手手手B.4 手手手手手手手B.5 手手手手手手手手手B.6 手手手手手手手手手
流程说明:
B.1. 飞信平台向VGOP发送查询邮箱未读邮件数请求;
B.2. VGOP进行能力互通鉴权 B.3. VGOP完成用户使用互通能力的鉴权 B.4. VGOP向手机邮箱平台转发查询未读邮件数请求 B.5. 手机邮箱平台向VGOP返回查询未读邮件数应答 B.6. VGOP向飞信平台转发查询未读邮件数应答
B.3 手机邮箱用户别名更新通知流程
B.3.1 方案A:控制流和业务流分离Push方案(推荐方案)
流程概述:手机邮箱平台向飞信平台推送更新的别名。在执行此动作之前,手机邮箱平台需要先到VGOP进行互通鉴权与路由,然后携带token与路由信息直接向飞信平台发起请求。
14