DSMP业务反向接口流程说明Word文档格式.doc

DSMP业务反向接口流程说明Word文档格式.doc

《DSMP业务反向接口流程说明Word文档格式.doc》由会员分享，可在线阅读，更多相关《DSMP业务反向接口流程说明Word文档格式.doc（11页珍藏版）》请在冰豆网上搜索。

消息类型

消息方向

SubscribeServiceReq

Request

SPà

DSMP

SubscribeServiceResp

Response

DSMPà

SP

1.2接口内容描述

SubscribeServiceReq消息字段描述：

字段名

重要性

类型

说明

MsgType

必须

string

TransactionID

该消息编号

Version

该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”

Send_Address

address_info_schema

发送方的地址

Dest_Address

接收方的地址

FeeUser_ID

user_id_schema

计费用户标识

DestUser_ID

使用用户标识

当计费用户和使用用户为同个用户的时候，FeeUser_ID和DestUser_ID的值为相同，否则填为不同的用户

Service_ID

service_id_schema

服务标识

FeatureStr

可选

binary

订购特征参数，订购业务需要携带的参数，可以携带文本/多媒体的相关信息

SubscribeServiceResp消息字段描述：

hRet

integer

返回值,见第9章的定义，如果返回成功，则下面几个参数必须存在，否则是可选的

LinkID

条件

临时订购关系的匹配码，用来鉴权一次点播请求等事务性的业务。

当DSMP生成的订购关系为临时订购关系的时候，返回本字段，否则不填本字段。

2、取消服务订购接口消息定义（UnSubscribeServiceReq）

2.1功能描述

此接口用于用户通过SP取消已订购的数据业务的时候，SP先通过该接口向DSMP进行用户取消服务订购的请求。

DSMP进行取消服务订购成功后，SP才取消用户对应的业务订购关系。

UnSubscribeServiceReq

UnSubscribeServiceResp

2.2接口内容描述

UnSubscribeServiceReq消息字段描述：

当使用用户和计费用户为同一用户的时候，FeeUser_ID和DestUser_ID的值相同。

UnSubscribeServiceResp消息字段描述：

返回值,见第9章的定义

3、订购关系同步消息接口消息定义（SyncOrderRelationReq）

3.1功能描述

此接口在DSMP因为某种情况更新了用户订购关系（包括订购、取消、暂停、激活）的时候，通过此接口发起和SP的更新订购关系的交互。

SyncOrderRelationReq

SyncOrderRelationResp

3.2接口内容描述

SyncOrderRelationReq消息字段描述：

返回定义

临时订购关系的事务ID

ActionID

服务状态管理动作代码，具体值如下：

1：

开通服务；

2：

停止服务；

3：

激活服务；

4：

暂停服务；

ActionReasonID

产生服务状态管理动作原因的代码，具体值如下：

用户发起行为

Admin&

1860发起行为

Boss停机

Boss开机

5：

Boss过户

6：

Boss销户

7：

Boss改号

8：

扣费失败导致的服务取消

9：

其他

SPID

SP的企业代码

SPServiceID

SP中该服务的服务代码

AccessMode

Integer

服务的访问方式

WEB

WAP

SMS

服务订购参数

SyncOrderRelationResp消息字段描述：

返回值，详细定义见第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