VGOP接口规范-能力互通接口(合)-v071.docVIP

 目 录 1. 1 2. 引用标准 2 3. 接口总体视图 2 4. 总体技术要求 3 4.1 消息类 3 4.1.1 协议 3 4.1.2 命名规则 3 4.1.3 接口双方责任 3 4.2 文件类 3 4.2.1 协议 3 4.2.2 命名规则 3 4.2.3 接口双方责任 3 4.3 数据库类 3 4.3.1 协议 3 4.3.2 命名规则 3 4.3.3 接口双方责任 3 5. VGOP能力互通调用接口 4 5.1 接口技术要求 4 5.1.1 通用技术要求 4 5.1.2 通用消息头 4 5.2 接口列表 5 5.3 用户互通设置类接口定义 6 5.3.1 VGOP-R2.1-01：用户互通设置接口 6 5.3.2 VGOP-R2.1-02：用户互通设置接口 6 5.3.3 VGOP-R2.1-03：互通设置信息同步接口 7 5.4 能力互通控制类接口定义 8 5.4.1 VGOP-R2.2-01：互通调用鉴权接口 8 5.5 平台能力调用类接口描述 9 5.6 平台能力提供类接口描述 9 5.7 能力互通访问类接口描述 9 5.8 返回值定义 9 5.9 Schema定义 9 6. 附录A. 飞信和手机邮箱能力互通相关接口参考 11 6.1 飞信-手机邮箱平台能力调用类接口参考建议 11 6.1.1 FETION-VGOP-R2.3-01：飞信平台到VGOP查询未读邮件数接口 11 6.1.2 FETION-VGOP-R2.3-02：订阅未读邮件数通知接口 12 6.1.3 FETION-VGOP-R2.3-03：取消订阅未读邮件数通知接口 13 6.1.4 FETION-VGOP-R2.3-04：通知未读邮件数接口 13 6.1.5 FETION-VGOP-R2.5-05：手机邮箱别名更新接口 14 6.2 飞信-手机邮箱平台能力提供类接口参考建议 15 6.2.1 MEM-VGOP-R2.4-01：手机邮箱提供未读邮件数接口 15 6.2.2 MEM-VGOP-R2.4-02：手机邮箱别名查询接口 15 6.3 飞信-手机邮箱能力互通访问类接口参考建议 16 6.3.1 FETION-MEM-R2.301：飞信平台到手机邮箱未读邮件数查询接口 16 7. 附录B. 业务流程参考 18 7.1 用户设置互通流程 19 7.1.1 用户互通设置流程 19 7.1.2 用户取消互通设置流程 19 7.2 查询未读邮件数流程 20 7.2.1 方案A：控制流和业务流分离查询方案（推荐方案） 20 7.2.2 方案B：控制流和业务流不分离查询方案 22 7.2.3 方案C：控制流和业务流分离订阅方案 22 7.2.4 方案D：控制流和业务流不分离订阅方案 23 7.3 手机邮箱用户别名更新通知流程 24 7.3.1 方案A：控制流和业务流分离别名更新通知（推荐方案） 24 7.3.2 方案B：控制流和业务流不分离方案 25 7.4 SSO登录流程 26 7.4.1 飞信SSO登录手机邮箱流程 26 适用范围 本规范规定了中国移动数据增值业务运营平台与各个业务网关以及应用平台之间的接口，以保证系统的互连互通及业务的实现。 本规范主要适用于中国移动数据增值业务运营平台，提供平台和业务平台、业务网关之间的连接的规范和技术实现规范。 本规范描述的是数据业务在运营过程中涉及到的业务接口，有关网管、系统管理的接口不在本规范的描述范围之内，具体请参见设备规范。  引用标准 下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。本标准出版时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。 接口总体视图 参见技术规范中相关内容（写明章节） 总体技术要求 消息类 协议 命名规则 接口双方责任 文件类 协议 命名规则 接口双方责任 数据库类 协议 命名规则 接口双方责任 VGOP能力互通调用接口 接口技术要求 XML进行描述。 消息发起的平台应支持超时重发机制，若业务平台在超时时间内未收到互通设置应答信息，则应重发互通设置请求。重发次数和重发间隔可配置平台根据应答错误代码做处理。 命名规则在本章节中保持统一。 接口消息名必须以动词或动词短语命名，单词间直接连接，每个单词首字母大写，缩略语全部大写。 消息内容定义中，消息字段（元素）参数名必须以名词或名词短语命名，单词间直接连接，第一个单词小写，以后每个单词首字母大写，缩略语全部大写。对用Schema定义的字段，在单词间加’_’连接符。 字段类型说明如下： int： 十进制的整数型； u_int： 十进制的无符号整数型； string： 由char组成的字符串； binary： 由byte组成的字符串，由于XML不能直接承载二进制数据