移动数据业务管理平台(DSMP)接口规范_ISMG分册.pdf

- 1 - 中 国 移 动 通 信 企 业 标 准 中 国 移 动 通 信 企 业 标 准 qb- qb- 移 动 数 据 业 务 管 理 平 台 (dsmp) 接 口 规 范 -ismg 分 册 （ 征 求 意 见 稿 ） 移 动 数 据 业 务 管 理 平 台 (dsmp) 接 口 规 范 -ismg 分 册 （ 征 求 意 见 稿 ） 中国中国移移动通信集团公司 发布动通信集团公司 发布 - - 发 布 - - 发 布 - - 实 施 - - 实 施 版 本 号 ： 1.6.0 版 本 号 ： 1.6.0 - 2 - 目目 录录 1. 适用范围 .5 2. 引用标准 .6 3. 相关术语与缩略语解释 .7 4. 文档结构概述 .8 5. 信令流程与接口规范 .9 5.1. 短信业务组网 .9 5.2. 接口消息实现 .10 5.3. 本地 mo_at （终端发起，应用中止）过程.10 5.3.1. 业务流程 .10 5.3.2. 接口定义 .11 5.4. 异地 mo_at（终端发起，应用中止）过程 .16 5.4.1. 业务流程 .16 5.4.2. 接口定义 .17 5.5. 本地 ao_mt （应用发起，终端中止）过程.18 5.5.1. 业务流程 .18 5.5.2. 接口定义 .19 5.6. 异地 ao_mt （应用发起，终端中止）过程.23 5.6.1. 业务流程 .23 5.6.2. 接口定义 .24 5.7. 本地包月业务 .24 5.7.1. 业务流程 .24 5.7.2. 接口定义 .26 5.8. 全网包月业务 .28 5.8.1. 业务流程 .28 5.8.2. 接口定义 .30 5.9. 本地业务订购 .30 5.9.1. 业务流程 .30 5.9.2. 接口定义 .31 5.10. 全网业务订购 .33 5.10.1. 业务流程 .33 5.10.2. 接口定义 .34 5.11. 本地业务取消订购.34 5.11.1. 业务流程 .34 5.11.2. 接口定义 .35 5.12. 全网业务取消订购业务.35 5.12.1. 业务流程 .35 5.12.2. 接口定义 .36 5.13. 话单传递 .36 5.13.1. 话单传递业务流程.36 5.13.2. 接口定义 .36 5.14. sp 登录过程.37 - 3 - 5.14.1. 登录业务流程.37 5.14.2. 接口定义 .37 5.15. 链路激活测试 .39 5.15.1. 链路激活测试流程.39 5.15.2. 接口定义 .39 6. 模式（schema）描述 .41 schema 字段描述.41 7. 编制历史 .44 - 4 - 前前 言言 本接口规范规定了中国移动通信集团公司移动数据业务管理平台（dsmp）短信部分涉及到的接口与 协议规范，详细定义了 dsmp 与业务网关之间的接口/协议，并给出 ismg 与 dsmp 连接的时序示意图以及 接口命令举例。本接口规范是集团公司进行 dsmp 与 ismg 进行互联的依据。 本规范解释权属于中国移动通信集团公司。 本规范起草单位：中国移动通信集团公司研发中心。 本标准主要起草人：魏冰、周彬、王崇平、段晓东、陈瑞卿、傅平达 感谢：黄宇红、孙少陵、刘祎、党京、丁晓诚、刘宝华、张鹏、李洪菊、孙学军、张彦超 - 5 - 1. 适用范围适用范围 本规范规定了中国移动 dsmp 平台与短消息网关之间的接口，以保证梦网短信业务业务管理、业务 控制的实现。 本规范主要适用于中国移动数据业务管理平台与 ismg 的互联的接口定义。 - 6 - 2. 引用标准引用标准 下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。本标准出版时，所示版本均为 有效。所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。 【1】 中国移动数据业务总体技术要求 【2】 ismg 与 scp 之间通信协议（事务层）规范 【3】 中国移动通信信息资源站实体与互联网短消息网关接口协议 【4】 移动梦网短信业务技术方案 【5】 中国移动通信互联网短信网关接口协议 【6】 itu_t 建议 q.1228(09/97) 【7】 ismg 与 scp 通信协议（事务层）规范（v1.0） 【8】 short message peer to peer protocol specification v3.4 【9】 ietf “rfc 2068: hypertext transfer protocol _ http/1.1” 【10】 w3c working draft soap version 1.2 part 2: adjuncts, martin gudgin, marc hadley, jean_jacques moreau, henrik frystyk nielsen, 2 10 2001 (see /tr/2001/wd_soap12_part2_20011217/.) 【11】 ietf rfc 2616: hypertext transfer protocol _ http/1.1, r. fielding, j. gettys, j. c. mogul, h. frystyk, t. berners_lee, january 1997. (see /rfc/rfc2616.txt.) 【12】 ietf rfc 2119: key words for use in rfcs to indicate requirement levels, s. bradner, march 1997. (see /rfc/rfc2119.txt.) 【13】 w3c recommendation xml schema part 1: structures, henry s. thompson, david beech, murray maloney, noah mendelsohn, 2 may 2001. (see /tr/2001/rec_xmlschema_1_20010502/.) 【14】 w3c recommendation xml schema part 2: datatypes, paul v. biron, ashok malhotra,2may2001.(see/tr/2001/rec_xmlschema_2_20010502/.) 【15】 ietf rfc 2396: uniform resource identifiers (uri): generic syntax, t. berners_lee, r. fielding, l. masinter, august 1998. (see /rfc/rfc2396.txt.) 【16】 w3c recommendation namespaces in xml, tim bray, dave hollander, andrew layman,14january1999.(see /tr/1999/rec_xml_names_19990114/.) 【17】 w3c recommendation extensible markup language (xml) 1.0 (second edition), tim bray, jean paoli, c. m. sperberg_mcqueen, eve maler, 6 october 2000. (see /tr/2000/rec_xml_20001006.) 【18】 w3c recommendation xml linking language (xlink) version 1.0, steve derose, eve maler, david orchard, 27 june 2001. (see /tr/2001/rec_xlink_20010627/.) 【19】 w3c recommendation xml information set, john cowan, richard tobin, 24 october 2001. (see /tr/2001/rec_xml_infoset_20011024/.) 【20】 w3c recommendation xml base, johnathan marsh, 27 june 2001. (see /tr/2001/rec_xmlbase_20010627/.) 【21】 ietf rfc 2732: format for literal ipv6 addresses in urls, r. hinden, b. carpenter, l. masinter, december 1999. (see /rfc/rfc2732.txt.) - 7 - 3. 相关术语与缩略语解释相关术语与缩略语解释 dsmp 数据业务管理平台 misc mobile information service center，移动信息服务中心 boss: business operation support system，业务运营支撑系统 scp service control point，服务控制点 icp: internet content provider，因特网内容提供商 cdr: call detail record，呼叫详细记录 mo mobile originate，手机用户发起 mt mobile terminate，手机用户终止 ao： application oriented，应用发起 at： application terminated，应用终止 ismg internet short message gateway，互联网短消息网关 smpp short message peer to peer，短消息点对点协议 smsc short message service center，短消息中心 sp service provider，服务提供商 cmpp china mobile peer to peer protocol，中国移动点对点协议 gsm global system for mobile communications 全球移动通信系统 xml extensible markup language，可扩展标记语言 - 8 - 4. 文档结构概述文档结构概述 本文档描述短信网关和 dsmp 之间的接口规范，该接口规范是基于 dsmp 引入后对短信业务的产生 影响而制定的规范，同时考虑短信网关已经组网运行了很长时间，系统、网络成熟，为保证对 ismg 系 统的影响降到最低，同时实现 dsmp 的基本功能（业务管理、鉴权等）而制订的的接口规范。 本文档描述短信业务的典型业务流程，以引出流程中用到的接口，然后对接口的元素进行描述。 - 9 - 5. 信令流程与接口规范信令流程与接口规范 5.1. 短信业务组网短信业务组网 网络连接示意图 组网方案如上图所示： （1） ismg 组网原则（包括 ismg 设置原则、ismg 前转原则、ismg 前转处理、ismg 服务范围） 保持不变。ismg 之间的连接如上图 d 连线所示，ismg 之间组成了 ismg 网状短消息接入 网； （2） ismg 和 scp 的组网原则（包括 ismg 和 scp 的连接方式、连接方式的选择原则、ismg 和 scp 的组网）保持不变； （3） ismg 与 smsc 的组网原则保持不变； 以上组网原则的详细描述参照移动梦网短信业务技术方案 。在组网图中，a,b,c 分别表示 区域 ismg 组网时，通过与 sp、smsc、scp 的连接，组成了三个 ismg 区域网； （4） ismg 的全网业务接入方式：全网 sms 业务可以分布接入所有 ismg（即每个 ismg 都可以 接入全网 sms 业务） ；也可以由一个固定的 ismg 接入所有全网业务。组网方式可以灵活适 - 10 - 应这种情况； （5） ismg 产生规定的各种话单，并传送到用户归属地的 boss，如图中 f 所示的连线； （8） ismg 与 dsmp 相连，通过这个连接，ismg 发送批价、用户管理、业务管理、鉴权请求， 并向 dsmp 实时传递生成的计费日志信息，由 dsmp 处理并回应，如图中 e 所示的连线； （9） sp 通过与 dsmp 连接，同步 dsmp 和 sp 之间的业务定购数据，如图中 g 所示的连线。 5.2. 接口消息实现接口消息实现 dsmp 接口格式采用基于 http 的 soap 协议，以 webservice 的方式进行相互之间的通信，要求 http 的协议为 1.1 以上。 对于 web service 接口定义以及和 soap 的邦定以及交互的消息例子请参 见数据业务管理平台接口规范 。 5.3. 本地本地 mo_at （终端发起，应用中止）过程（终端发起，应用中止）过程 5.3.1. 业务流程业务流程 smscismgdsmpscpsp 1、smpp_deliver 2、smpp_deliver_resp 3、authpricereq 4、authpriceresp 5、sm_chg_req 6、sm_chg_resp 7、cmpp_deliver 8、cmpp_deliver_resp sendcdrreq sendcdrresp 9、sm_cnfm_req 10、sm_cnfm_resp 短信本地mo_at业务流程短信本地mo_at业务流程 流程描述： （1） smsc 向 ismg 提交短消息 deliver_sm(smpp)； （2） ismg 收到操作后，立即给 smsc 返回相应的应答消息 deliver-sm-resp(smpp)； （3） ismg 向 dsmp 发送鉴权批价请求，在此消息内应包括使用用户标识(发起 mo 的手 机号码)、服务标识（sp 服务代码） 、mo 消息内容等相关信息； - 11 - （4） dsmp 解析 mo 消息的内容，判断本条 mo 消息的操作类型，如果是订购/取消订购 请求，请看相关的业务流程；对于点播的 mo 请求，dsmp 为本次点播业务生成一个临 时订购关系(以 linkid 标识)，并返回给 ismg，ismg 将通过 cmpp 协议将 linkid 传递 到 sp，sp 下发该次点播的 mt 时，将携带此 linkid，dsmp 根据此 linkid 对该条 mt 消息进行鉴权；对于普通的 mo 消息，dsmp 将不生成 linkid。dsmp 向 ismg 返回鉴 权和计费结果。 ； （5） 如果是神州行用户，ismg 向 scp 发送计费请求，全球通用户则跳到第 7 步； （6） scp 返回结果：可能的结果有：手机为非神州行用户、神州行用户并且扣费成功、神 州行用户并且扣费失败；ismg 应该记录该信息，并且进行判断，如果结果为神州行用 户并且扣费失败，则流程以失败终止，否则流程继续往下进行；若 ismg 未收到 scp 的 应答，也中断此流程； （7） ismg 向 sp 转发消息； （8） sp 向 ismg 返回应答消息； （9） 如果是神州行用户，ismg 根据应答消息的返回值向 scp 发起扣款确认/补款请求， 全球通用户跳到第 11 步； （10） scp 向 ismg 返回应答； 非实时流程： 1、ismg 向 dsmp 传递生成的计费日志(包括成功和不成功的)； 2、dsmp 接收到话单后，返回应答消息； 5.3.2. 接口定义接口定义 参照业务流程，dsmp 和 ismg 在本地 mo_at 过程中使用鉴权批价和话单传递的接口。 . 鉴权鉴权/批价接口消息定义批价接口消息定义(authpricereq) 功能描述功能描述 在实际的业务流程中为了减少业务网关和 dsmp 的交互次数，将服务鉴权、用户鉴权、mo 消息批 价的功能合在一个接口中完成，本接口就是完成这个功能。 消息名消息名 消息类型消息类型 消息方向消息方向 authpricereq request 业务网关?dsmp authpriceresp response dsmp?业务网关 接口内容描述接口内容描述 authpricereq 消息字段描述： - 12 - 字段名字段名 重要性重要性 类型类型 说明说明 msgtype 必须 string 消息类型 transactionid 必须 string 该消息编号 version 必须 string 该接口消息的版本号，本次所有 的接口消息的版本都为“1.5.0” send_address 必须 address_info_schema 发送方的地址 dest_address 必须 address_info_schema 接收方的地址 msgid 条件 string msgid内容与该条短信话单中的msgid 相同，对短信业务，本字段必须填写 feeuser_id 条件 user_id_schema mo的时候，本字段不填 destuser_id 必须 user_id_schema 使用用户标识 service_id 必须 service_id_schema 服务标识，此处取值为： serviceidtype=2(根据接入号和特征 串确定服务) accessno=服务代码 featurestr为mo消息的内容， 如内容为 空，该字段也填为空 linkid 可选 string 点播类业务的鉴权匹配码 本字段只对点播类业务的业务下发消 息有效，其他业务本字段填空 mo的时候本字段不填 servicetype 必须 integer 服务类别填为1(smsmo) authpriceresp 消息字段描述： - 13 - 字段名字段名 重要性重要性 类型类型 说明说明 msgtype 必须 string 消息类型 transactionid 必须 string 该消息编号 version 必须 string 该接口消息的版本号，本次所有 的接口消息的版本都为“1.5.0” hret 必须 integer 返回值，见dsmp接口规范第9章的定 义 feetype 条件 integer 计费类型 0：“短消息类型”为“发送”，对“计 费用户号码”不计信息费，此类话单仅 用于核减sp对称的信道费 1：对“计费用户号码”免费 2：对“计费用户号码”按条计信息费 3：对“计费用户号码”按包月收取信 息费 4：对“计费用户号码”的信息费封顶 5：对“计费用户号码”的收费是由sp 实现 feecode 条件 integer 批价出来的费用,以分为单位 在本规范中， 对整数数据类型采用10进 制asc字符串来传递，以下整型变量类 同 feemsisdn 条件 string 计费用户号码 feepseudocode 条件 binary 计费用户伪码 destmsisdn 条件 string 使用用户号码 destpseudocode 条件 binary 使用用户伪码 sendspuseridtyp e 条件 integer 传递给sp的用户标识类型 1：传手机号 2：传伪码 3：传手机号码和伪码 opertype 条件 integer 本消息包的操作类型 1：订购 2：取消订购 3：点播 4：待扩展 本字段只对提供订购通道的业务有效， 例如短信的mo消息,在服务鉴权的时 候，根据service_id中的信息，dsmp - 14 - 解析出具体的操作码，对于普通的业务 消息，本字段不填。 linkid 条件 string 对点播操作dsmp生成临时订购关系， 并产生此临时订购关系的事务标识 (linkid)，对非点播类的操作，本字段 不填。 usertype 条件 integer 用户类型(全球通、神州行) 0：全球通 1：神州行 2、待扩展 spid 条件 string 企业代码 spserviceid 条件 string 业务代码 connectdeviceid 条件 string 服务接入网关的编号，ismg判断本字 段如果不是本网关则根据网关id进行 前转 . 话单传送请求接口消息定义话单传送请求接口消息定义(sendcdrreq) 功能描述功能描述 此接口用于各业务网关和 portal 将自己生成的计费话单上传给 dsmp。 消息名消息名 消息类型消息类型 消息方向消息方向 sendcdrreq request 业务网关?dsmp sendcdrresp response dsmp?业务网关 接口内容描述接口内容描述 sendcdrreq 消息字段描述： 字段名字段名 重要性重要性 类型类型 说明说明 msgtype 必须 string 消息类型 transactionid 必须 string 该消息编号 version 必须 string 该接口消息的版本号，本次所有 的接口消息的版本都为“1.5.0” send_address 必须 address_info_schema 发送方的地址 dest_address 必须 address_info_schema 接收方的地址 - 15 - platformtype 必须 integer 业务类型，根据此类型判断话单 1：sms 2：wap 3：mms 4：kjava 5：mail 6：lsp 7：www 8：扩展 cdr 必须 cdr_schema 话单，不同的网关和portal传送不同的 话单 sendcdrresp 消息字段描述： 字段名字段名 重要性重要性 类型类型 说明说明 msgtype 必须 string 消息类型 transactionid 必须 string 该消息编号 version 必须 string 该接口消息的版本号，本次所有 的接口消息的版本都为“1.5.0” hret 必须 integer 返回值, 见dsmp接口规范第9章的定 义 - 16 - 5.4. 异地异地 mo_at（终端发起，应用中止）过程（终端发起，应用中止）过程 5.4.1. 业务流程业务流程 smsc 归属地ismg归属地dsmp scpsp 1、smpp_deliver 2、smpp_deliver_resp 3、authpricereq 4、authpriceresp 5、sm_chg_req 6、sm_chg_resp 7、cmpp_fwd 8、cmpp_fwd_resp 13、sm_cnfm_req 14、sm_cnfm_resp 短信异地mo_at业务流程短信异地mo_at业务流程 接入地ismg接入地dsmp 9、cmpp_deliver 10、cmpp_deliver_resp 11、cmpp_fwd（状态报告） 12、cmpp_fwd_resp 流程描述： （1） smsc 向归属地 ismg 提交短消息 deliver_sm(smpp)； （2） 归 属 地ismg收 到 操 作 后 ， 立 即 给smsc返 回 相 应 的 应 答 消 息 deliver-sm-resp(smpp)； （3） 归属地 ismg 向归属地 dsmp 发送鉴权批价请求，在此消息内应包括使用用户标识 发起 mo 的手机号码)、服务标识（服务代码） 、mo 消息内容等相关信息； （4） dsmp 解析 mo 消息的内容，判断本条 mo 消息的操作类型，如果是订购/取消订购 请求，请看相关的业务流程；对于点播的 mo 请求，dsmp 为本次点播业务生成一个临 时订购关系(以 linkid 标识)，并返回给 ismg，ismg 将通过 cmpp 协议将 linkid 传递 到 sp，sp 下发该次点播的 mt 时，将携带此 linkid，dsmp 根据此 linkid 对该条 mt 消息进行鉴权；对于普通的 mo 消息，dsmp 将不生成 linkid。dsmp 向 ismg 返回鉴 - 17 - 权和计费结果； （5） 如果是神州行用户，归属地 ismg 向 scp 发送计费请求，全球通用户跳到第 7 步； （6） scp 返回结果：可能的结果有：手机非神州行用户、神州行用户并且扣费成功、神州 行用户并且扣费失败；源 ismg 应该记录该信息，并且进行判断，如果结果为神州行用 户并且扣费失败，则流程以失败终止，否则流程继续往下进行；若 ismg 未收到 scp 的 应答，也中断此流程； （7） 归属地 ismg 向业务接入地 ismg 转发消息； （8） 业务接入地 ismg 向归属地 ismg 返回应答消息； （9） 业务接入地 ismg 向 sp 转发 mo 消息; （10） sp 返回应答消息; （11） 业务接入地 ismg 向源 ismg 发送 mo 状态报告; （12） 源 ismg 返回应答消息; （13） 如果是神州行用户，源 ismg 根据 mo 状态报告向 scp 发起扣款确认/补款请求； （14） scp 向 ismg 返回应答； 5.4.2. 接口定义接口定义 参照业务流程，dsmp 和 ismg 在异地 mo_at 过程中使用鉴权批价接口，接口的定义和 5.3.2 节相 同，在此不再重复。 - 18 - 5.5. 本地本地 ao_mt （应用发起，终端中止）过程（应用发起，终端中止）过程 5.5.1. 业务流程业务流程 smsc ismgdsmp scp sp 1、cmpp_submit 2、cmpp_submit_resp 3、authpricereq 4、authpriceresp 5、sm_chg_req 6、sm_chg_resp 11、sm_cnfm_req 12、sm_cnfm_resp 短信本地ao_mt业务流程短信本地ao_mt业务流程 7、smpp_submit 8、smpp_submit_resp 9、smpp_deliver 10、smpp_deliver_resp 13、cmpp_deliver 14、cmpp_deliver_resp 流程描述： （1）sp 向 sp 所接入的 ismg 下发短消息 cmpp_submit； （2）ismg 立即给 sp 返回一条应答消息 cmpp_submit_resp； （3）ismg 向 dsmp 管理平台发送用户鉴权及批价请求消息； （4）dsmp 管理平台对网关发来的用户鉴权及批价请求消息进行分析，进行业务鉴权、用户鉴权、 订购关系鉴权、实时批价，并将结果返回给 ismg,，如鉴权失败，则返回错误信息给 ismg； （5）如果是神州行用户，ismg 根据 dsmp 批出的信息费发起扣费请求，全球通用户跳到第 7 步； （6）scp 返回应答消息； （7）ismg 向 smsc 转发 mt 消息； （8）smsc 返回应答； （9）smsc 一直尝试着向手机用户发送短消息， 一直到用户成功接收到短消息， 或者该短消息超过 有效期；smsc 给目的 ismg 发送一条状态报告消息，表示用户是否最终接收到了短消息； - 19 - （10） ismg 立即给 smsc 应答一条相应的消息； （11） 如果是神州行用户根据状态报告的状态，ismg 向 scp 发送扣款确认/补款请求，全球通用 户跳到第 13 步； （12） scp 返回应答消息； （13） ismg 向 sp 返回状态报告； （14） sp 返回应答消息; 5.5.2. 接口定义接口定义 参照业务流程，dsmp 和 ismg 在 ao_mt 过程中使用了一个接口，为鉴权批价接口。 . 鉴权鉴权/批价接口消息定义批价接口消息定义(authpricereq) 功能描述功能描述 在实际的业务流程中为了减少业务网关和 dsmp 的交互次数，将服务鉴权、用户鉴权、mo 消息批 价的功能合在一个接口中完成，本接口就是完成这个功能。 消息名消息名 消息类型消息类型 消息方向消息方向 authpricereq request 业务网关?dsmp authpriceresp response dsmp?业务网关 接口内容描述接口内容描述 authpricereq 消息字段描述： 字段名字段名 重要性重要性 类型类型 说明说明 msgtype 必须 string 消息类型 transactionid 必须 string 该消息编号 version 必须 string 该接口消息的版本号，本次所有 的接口消息的版本都为“1.5.0” send_address 必须 address_info_schema 发送方的地址 dest_address 必须 address_info_schema 接收