DSMP业务反向接口流程说明

DSMP SP业务反向订购接口业务反向订购接口 由于SP开展数据业务的多样化 对于某些特定的业务 在业务的 管理上需要增加SP业务反向订购的功能 及必须由手机用户通过SP端 提出业务订购申请 此接口为DSMP 与SP 之间的接口 SP可以通过该接口进行订购关 系增加和取消 此接口同时适用于WAP SP 短信SP 以及后续的业务类型 此接口非缺省开放的接口 数据业务管理部门根据业务的需要决 定向需要的SP开放 1 数据处理流程描述数据处理流程描述 SPMISC SubscribeServiceReq 接入鉴权 用户鉴权 业务鉴权 SyncOrderRelationReq SyncOrderRelationResp 出包月话单 生成订购关系 SubscribeServiceResp 反向订购流程描述 反向订购是从 SP 发起的订购流程 MISC 在处理来自 SP 的订购消 息的时候 其处理流程和来自其他网元的消息一样处理 流程如下 1 SP 收到用户的定购请求后 向 MISC 发起订购请求 SubscribeServiceReq 并等待 MISC 处理响应消息 2 MISC 对消息中的业务鉴权接入鉴权 判断该业务是否允许进行 反向订购 3 进行用户鉴权和订购关系鉴权 判断用户状态是否正确以及是 否是重复定购等 4 MISC 向 SP 发送订购关系同步请求 SyncOrderRelationReq 5 SP 收到同步请求后 对这个定购请求做相应的定购关系处理 并返回订购关系同步应答 SyncOrderRelationResp 6 MISC 收到响应后在 MISC 里面生成正式的定购关系 并返回 SP 反向定购处理响应 SubscribeServiceResp 如果响应正确则转到 8 7 如果收到 MISC 的错误响应 则说明定购失败 SP 必须对这个 失败消息做相应处理 比如把生成的定购关系清除 8 如果收到 MISC 的正确响应 则 SP 可以不做任何处理 2 服务订购接口消息定义 服务订购接口消息定义 SubscribeServiceReq 1 1 功能描述功能描述 此接口用于用户通过 SP 订购数据业务的时候 SP 先进行业务关系订购 再通过该接口向 DSMP 进行用户服务订购的请求 DSMP 进行服务订购 消息名消息名消息类型消息类型消息方向消息方向 SubscribeServiceReqRequestSP DSMP SubscribeServiceRespResponseDSMP SP 1 2 接口内容描述接口内容描述 SubscribeServiceReq 消息字段描述 字段名字段名重要性重要性类型类型说明说明 MsgType必须 string消息类型 TransactionID必须 string该消息编号 Version必须 string该接口消息的版本号 本次所有 的接口消息的版本都为 1 5 0 Send Address必须address info schema发送方的地址 Dest Address必须address info schema接收方的地址 FeeUser ID必须user id schema计费用户标识 DestUser ID必须user id schema使用用户标识 当计费用户和使用用户为同个用户的 时候 FeeUser ID和DestUser ID的 值为相同 否则填为不同的用户 Service ID必须service id schema服务标识 FeatureStr可选binary订购特征参数 订购业务需要携带的 参数 可以携带文本 多媒体的相关信 息 SubscribeServiceResp 消息字段描述 字段名字段名重要性重要性类型类型说明说明 MsgType必须 string消息类型 TransactionID必须 string该消息编号 Version必须 string该接口消息的版本号 本次所有 的接口消息的版本都为 1 5 0 hRet必须integer返回值 见第9章的定义 如果返回成 功 则下面几个参数必须存在 否则 是可选的 LinkID条件string临时订购关系的匹配码 用来鉴权一 次点播请求等事务性的业务 当DSMP 生成的订购关系为临时订购关系的时 候 返回本字段 否则不填本字段 2 取消服务订购接口消息定义 取消服务订购接口消息定义 UnSubscribeServiceReq 2 1 功能描述功能描述 此接口用于用户通过 SP 取消已订购的数据业务的时候 SP 先通过该接口向 DSMP 进行 用户取消服务订购的请求 DSMP 进行取消服务订购成功后 SP 才取消用户对应的业务订购 关系 消息名消息名消息类型消息类型消息方向消息方向 UnSubscribeServiceReqRequestSP DSMP UnSubscribeServiceRespResponseDSMP SP 2 2 接口内容描述接口内容描述 UnSubscribeServiceReq 消息字段描述 字段名字段名重要性重要性类型类型说明说明 MsgType必须 string消息类型 TransactionID必须 string该消息编号 Version必须 string该接口消息的版本号 本次所有 的接口消息的版本都为 1 5 0 Send Address必须address info schema发送方的地址 Dest Address必须address info schema接收方的地址 FeeUser ID必须user id schema计费用户标识 DestUser ID必须user id schema使用用户标识 当使用用户和计费用户为同一用户的 时候 FeeUser ID和DestUser ID的 值相同 Service ID必须service id schema服务标识 UnSubscribeServiceResp 消息字段描述 字段名字段名重要性重要性类型类型说明说明 MsgType必须 string消息类型 TransactionID必须 string该消息编号 Version必须 string该接口消息的版本号 本次所有 的接口消息的版本都为 1 5 0 hRet必须integer返回值 见第9章的定义 3 订购关系同步消息接口消息定义 订购关系同步消息接口消息定义 SyncOrderRelationReq 3 1 功能描述功能描述 此接口在 DSMP 因为某种情况更新了用户订购关系 包括订购 取消 暂停 激活 的 时候 通过此接口发起和 SP 的更新订购关系的交互 消息名消息名消息类型消息类型消息方向消息方向 SyncOrderRelationReqRequestDSMP SP SyncOrderRelationRespResponseSP DSMP 3 2 接口内容描述接口内容描述 SyncOrderRelationReq 消息字段描述 返回定义返回定义重要性重要性类型类型说明说明 MsgType必须 string消息类型 TransactionID必须 string该消息编号 Version必须 string该接口消息的版本号 本次所有 的接口消息的版本都为 1 5 0 Send Address必须address info schema发送方的地址 Dest Address必须address info schema接收方的地址 FeeUser ID 必须user id schema计费用户标识 DestUser ID 必须user id schema 使用用户标识 LinkID 可选string 临时订购关系的事务ID ActionID必须integer服务状态管理动作代码 具体值 如下 1 开通服务 2 停止服务 3 激活服务 4 暂停服务 ActionReasonID必须integer产生服务状态管理动作原因的代 码 具体值如下 1 用户发起行为 2 Admin 1860 发起行为 3 Boss 停机 4 Boss 开机 5 Boss 过户 6 Boss 销户 7 Boss 改号 8 扣费失败导致的服务取消 9 其他 SPID可选stringSP 的企业代码 SPServiceID必须stringSP 中该服务的服务代码 AccessMode可选Integer服务的访问方式 1 WEB 2 WAP 3 SMS FeatureStr可选binary服务订购参数 SyncOrderRelationResp 消息字段描述 字段名字段名重要性重要性类型类型说明说明 MsgType必须 string消息类型 TransactionID必须 string该消息编号 Version必须 string该接口消息的版本号 本次所有 的接口消息的版本都为 1 5 0 hRet必须integer返回值 详细定义见第9章 3 附录附录 B 返回值定义返回值定义 在HTTP 通信时的状态码请参见HTTP 1 1 协议中规定的状态码值 不包含在本 规范的返回值统一定义中 具体描述如下 0 成功 1 未知错误 2 99 保留 4000 4999 为DSMP 与SP 之间的接口消息中的错误代码 4000 无效的msgtype 4001 无效的action id 4002 无效的action reasonid 4003 无效的SP ID 4004 无效的serviceID 4005 无效的pseudocode 4006 无效的accessmode 4007 MISC 同步开通服务 但SP 端已存在订购关系 且状态为开通 4008 MISC 同步开通服务 且SP 端不存在订购关系 但开通服务失败 4009 MISC 同步开通服务 但SP 端已存在订购关系 且状态为暂停 4010 MISC 同步停止服务 且SP 端存在订购关系 但取消服务失败 4011 MISC 同步停止服务 但SP 端不存在订购关系 4012 MISC 同步暂停服务 且SP 端存在订购关系 但暂停服务失败 4013 MISC 同步暂停服务 但SP 端不存在订购关系 4014 MISC 同步暂停服务 但SP 端已存在订购关系 且状态为暂停 4015 MISC 同步激活服务 但SP 端已存在订购关系 且状态为开通 4016 MISC 同步激活服务 但SP 端不存在订购关系 4017 MISC 同步激活服务 且SP 端存在订购关系 但激活服务失败 9000 9999 为系统级错误 9000 系统磁盘读写错误 9001 网络异常 9002 网络错误 9003 业务网关忙 业务网关缓存 9004 业务网关忙 并且业务网关缓冲区满 DSMP 缓存 并暂时不要发送消 息 等待一段时间重试 9005 DSMP 忙 DSMP 缓存 9006 DSMP 忙 并且DSMP 缓冲区满 业务网关缓存 并暂时不要发送消息 等待一段时间重试 9007 业务网关超过限制的流量 9008 DSMP 异常 并不可用 9009 业务网关异常 并不可用 9010 该业务网关没有权限调用该接口消息 9011 DSMP 没有权限发送该接口消息给业务网关 9012 版本不支持 9013 消息类型不对 系统不支持 9014 验证错误 无法解析SOAP 和XML 结构 缺少必须存在的字段 或者消 息 格式不正确 9015 拒绝消息 服务器无法完成请求的服务 4 附录附录 B