QB-GF-003-2003 A.2.5 FETION-MEM-R2.4-05:取消订阅未读邮件数通知接口 1. 接口描述
此接口用于飞信平台向手机邮箱平台取消订阅未读邮件数通知。
2. 接口消息
消息名 UnsubscribeUnreadMailNumReq UnsubscribeUnreadMailNumResp
消息类型 Request Response 消息描述 消息方向 取消订阅未读邮件数通知请求 飞信?VGOP 取消订阅未读邮件数通知响应 VGOP?飞信 3. 消息字段定义
?
UnsubscribeUnreadMailNumReq 字段名 类型 是否必选 (空) ?
UnsubscribeUnreadMailNumResp 字段名 类型 ResultCode
Integer 描述 是否必选 必须 返回值:0成功 描述 其他参考5.8返回值定义 A.2.6 MEM-FETION-R2.4-06:PUSH别名更新接口 1. 接口含义
手机邮箱平台向VGOP PUSH别名更新。所有手机邮箱用户别名更新后,都向飞信PUSH更新的别名。
2. 接口消息
消息名 PushAliasUpdateReq PushAliasUpdateResp 消息类型 Request Response 消息描述 PUSH别名更新请求 PUSH别名更新响应 消息方向 邮箱平台?飞信平台 飞信平台?邮箱平台 3. 接口字段定义
5
QB-GF-003-2003 ?
PushAliasUpdateReq消息字段描述 字段名 Alias 重要性 必须 String 类型 说明 更新的别名 ? PushAliasUpdateResp消息字段描述 字段名 ResultCode 重要性 必须 integer 类型 说明 返回值:0成功 其他参考5.8返回值定义
A.3 能力互通访问类接口参考建议
本节描述飞信与手机邮箱互通中,飞信与手机邮箱平台直接相互访问的接口类。
此类接口主要用户控制流与业务流分离情况下,业务平台之间先通过VGOP进行相对独立的控制,之后进行直接访问。
A.3.1 FETION-MEM-R2.5-01:查询未读邮件数接口 1. 接口含义
此接口用于飞信平台查询用户未读邮件数量。飞信平台通过该接口直接向手机邮箱平台进行查询请求。
2. 接口消息
消息名 QueryUnreadMailNumReq QueryUnreadMailNumResp 消息类型 Request Response 消息描述 用户未读邮件数查询请求 用户未读邮件数查询响应 消息方向 飞信平台?邮箱平台 邮箱平台?飞信平台 3. 接口字段定义
?
QueryUnreadMailNumReq消息字段描述 字段名 User_ID Token 重要性 必须 必须 类型 user_id_schema String 说明 用户标识 ? QueryUnreadMailNumResp消息字段描述
6
QB-GF-003-2003 字段名 ResultCode 重要性 必须 integer 类型 说明 返回值:0成功 其他参考5.8返回值定义 Unread_Mail_Num 必须 integer 未读邮件数量
A.3.2 FETION-MEM-R2.5-02:订阅未读邮件数通知接口 1. 接口描述
手机邮箱提供未读邮件数能力。飞信平台可直接向手机邮箱通过此接口订阅未读邮件数更新通知。这样当手机邮箱平台检测到未读邮件数有更新时,可以向飞信平台通知更新的未读邮件数量。
2. 接口消息
消息名 SubscribeUnreadMailNumReq SubscribeUnreadMailNumResp
消息类型 Request Response 消息描述 订阅未读邮件数通知请求 订阅未读邮件数通知响应 消息方向 FETION?MEM MEM?FETION 3. 消息字段定义
?
SubscribeUnreadMailNumReq 字段名 类型 是否必选 订阅的过期时间。 Auto_Unsubscribe_ Timeout Integer 必须 以秒为单位的32位无符号整数;需要在订阅过期之前进行续订。 续订也使用这个接口。 ?
SubscribeUnreadMailNumResp 字段名 类型 ResultCode
Integer 描述 是否必选 必须 返回值:0成功 描述 其他参考5.8返回值定义 7
QB-GF-003-2003 A.3.3 FETION-MEM-R2.5-03:取消订阅未读邮件数通知接口 1. 接口描述
此接口用于飞信平台向手机邮箱平台取消订阅未读邮件数通知。
2. 接口消息
消息名 UnsubscribeUnreadMailNumReq 消息类型 Request 消息描述 消息方向 取消订阅未读邮件数通知请求 FETION?MEM 取消订阅未读邮件数通知响应 MEM?FETION UnsubscribeUnreadMailNumResp Response
3. 消息字段定义
?
UnsubscribeUnreadMailNumReq 字段名 类型 (空) ?
UnsubscribeUnreadMailNumResp 字段名 类型 ResultCode
Integer 是否必选 必须 描述 返回值:0成功 其他参考5.8返回值定义 是否必选 描述 A.3.4 MEM-FETION-R2.5-04:通知未读邮件数接口 1. 接口描述
飞信平台向手机邮箱平台订阅了未读邮件数更新通知接口后,当手机邮箱平台检测到某用户的未读邮件数更新时,向飞信平台发起通知。
2. 接口消息
消息名 NotifyUnreadMailNumReq 消息类型 Request 消息描述 通知未读邮件数 通知未读邮件数响应 消息方向 MEM?FETION FETION?MEM NotifyUnreadMailNumResp Response
8
QB-GF-003-2003 3. 消息字段定义
? NotifyUnreadMailNumReq 字段名 类型 是否必选 必须 未读邮件数量 描述 Unread_Email_Num integer ? NotifyUnreadMailNumResp 字段名 类型 Integer 是否必选 必须 描述 返回值:0成功 其他参考5.8返回值定义 ResultCode
A.3.5 MEM-FETION-R2.5-05:PUSH别名更新接口 1. 接口含义
手机邮箱平台向VGOP PUSH别名更新。所有手机邮箱用户别名更新后,都向飞信PUSH更新的别名。
2. 接口消息
消息名 PushAliasUpdateReq PushAliasUpdateResp 消息类型 Request Response 消息描述 PUSH别名更新请求 PUSH别名更新响应 消息方向 邮箱平台?飞信平台 飞信平台?邮箱平台 3. 接口字段定义
?
PushAliasUpdateReq消息字段描述 字段名 Alias 重要性 必须 String 类型 说明 更新的别名 ? PushAliasUpdateResp消息字段描述 字段名 ResultCode 重要性 必须 integer 类型 说明 返回值:0成功 其他参考5.8返回值定义
A.3.6 FETION-MEM-R2.5-08:飞信客户端单点登录手机邮箱SSO接口 1. 接口含义
9