DSMP业务反向接口流程说明.doc
- 文档编号:230319
- 上传时间:2022-10-07
- 格式:DOC
- 页数:11
- 大小:287KB
DSMP业务反向接口流程说明.doc
《DSMP业务反向接口流程说明.doc》由会员分享,可在线阅读,更多相关《DSMP业务反向接口流程说明.doc(11页珍藏版)》请在冰豆网上搜索。
DSMPSP业务反向订购接口
由于SP开展数据业务的多样化,对于某些特定的业务,在业务的管理上需要增加SP业务反向订购的功能,及必须由手机用户通过SP端提出业务订购申请。
此接口为DSMP与SP之间的接口,SP可以通过该接口进行订购关系增加和取消。
此接口同时适用于WAPSP,短信SP,以及后续的业务类型。
此接口非缺省开放的接口,数据业务管理部门根据业务的需要决定向需要的SP开放。
1、数据处理流程描述
反向订购流程描述:
反向订购是从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进行服务订购。
消息名
消息类型
消息方向
SubscribeServiceReq
Request
SPàDSMP
SubscribeServiceResp
Response
DSMPà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才取消用户对应的业务订购关系。
消息名
消息类型
消息方向
UnSubscribeServiceReq
Request
SPàDSMP
UnSubscribeServiceResp
Response
DSMPà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的更新订购关系的交互。
消息名
消息类型
消息方向
SyncOrderRelationReq
Request
DSMPàSP
SyncOrderRelationResp
Response
SPà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
可选
string
SP的企业代码
SPServiceID
必须
string
SP中该服务的服务代码
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:
无效的SPID
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:
接口实例
4.1、SP订购请求包
xmlversion="1.0"encoding="U
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DSMP 业务 反向 接口 流程 说明
![提示](https://static.bdocx.com/images/bang_tan.gif)