中兴“IP直通车”营帐服务系统接口方案

1中兴“IP直通车”营帐服务系统接口方案一、功能中兴“IP直通车”营帐服务系统提供以下功能：1、手机开户/销户受理台提供手机（为业务支付费用的账户）开户/销户功能所需的手机号码、用户姓名等信息。2、绑定电话开户/销户受理台提供绑定电话（手机使用业务的用户）开户/销户功能所需的固定电话号码、手机号码、帐号密码等信息。3、手机激活/去激活受理台提供手机激活/去激活功能所需的手机号码、激活/去激活标志信息。4、绑定电话停/复机受理台提供绑定电话停/复机功能所需的固定电话号码、停/复机标志等信息。5、修改绑定电话密码受理台提供修改绑定电话密码功能所需的固定电话号码、旧密码、新密码等信息。6、取消绑定电话密码受理台提供取消绑定电话密码功能所需的固定电话号码、密码等信息。7、开通/禁拨绑定电话国际长途受理台提供开通/禁拨绑定电话国际长途功能所需的固定电话号码、开通/禁拨标志等信息。8、设置/取消绑定电话禁拨号码受理台提供设置/取消绑定电话禁拨号码功能所需的固定电话号码、禁拨号码等信息。9、查询绑定电话信息受理台提供查询绑定电话信息功能所需的固定电话号码信息。返回信息：所属手机号码、电话现有状态（开机/停机）、通话级别（国际长途开通情况）有无密码等。二、接口协议2.1连接“IP直通车”营帐系统与SMP在发送消息前，必须与SMP建立TCP/IPSOCKET连接。在”IP直通车”营帐系统不再需要与SMP进行交互后，必须拆除与SMP的SOCKET连接。在空闲时，可以保持与SMP的连接，此时只需要发送心跳消息。SMP与各”IP直通车”营帐系统间可以建立的最大连接数参见有关部门的相关要求。2.2消息接口协议的业务消息用于传递用户的操作信息，是“IP直通车”营帐系统与SMP进行交互的最小单位。在创建了连接、会话并确定了事务ID之后，“IP直通车”营帐系统根据接口协议的消息格式将功能命令打成消息包发送给SMP，并将接收到的包根据接口协议的消息格式进行解码。消息结构如图1所示：2接口协议的心跳消息用于检测综合业务中心与SMP间的连接是否正常，在检测到连接空闲120秒后发送。心跳消息结构如图2所示：2.2.1业务消息的编码接口协议的参数编码参数编码应符合以下原则：1）传送的消息数据流以网络字节序为准。2）如果字符串不满规定长度，用空格填充；2..2.1.1消息开始标志消息开始标志用于确定消息的开始和结束，长度为4Byte。编码为：`SC`。2.2.1.2消息长度(4Byte)消息长度用来指出从消息头到操作信息的总长度。长度值用16进制字符(0-F)表示的4位整数来表示。消息长度取值范围为0到65000(0000-FFFF)。2.2.1.3消息头(20Byte)消息头包含以下参数：-版本号：用来识别接口的协议版本。编码为4个八位位组的字符串。目前的版本为1.00。如果以后有协议升版，按新版本进行编码即可。-终端标识：用于标识接入SMP的”IP直通车”营帐系统的前置机和终端。编码为8个八位位组的字符串，即PPZZABCD，其中，PP和ZZ可以是字母和数字的任意组合，ABCD只能是数字。特别地，在首次登录时，“终端标识”的内容必须填写分配给”IP直通车”营帐系统前置机的终端标识。在以后发送的消息中，应该填写具体终端的终端标识。SMP只对前置机的终端标识进行鉴权。PP表示省、自治区和直辖市。PP的编码暂时使用下表定义的方式。名称编码北京BJ天津TJ河北HB山西SX内蒙古NM辽宁LN吉林JL消息开始标志消息长度填充内容校验和消息发送顺序消息开始标志消息长度消息头会话头事务头操作信息校验和消息开始标志消息发送顺序图1消息结构图2心跳消息结构3黑龙江HL上海SH江苏JS浙江ZJ安徽AH福建FJ江西JX山东SD河南HN湖北UB湖南UN广东GD海南IN广西GX重庆CQ四川SC贵州GZ云南YN陕西HX甘肃GS青海QH宁夏NX新疆XJZZABCD表示终端序号，由各省公司自行分配。-服务名：操作员所要请求的服务。编码为8个八位位组的字符串，即XXXABCDE。其中，XXX三个字节表示业务，ABCDE五个字节表示具体的服务名。目前已经分配的业务名有PPC（预付费业务）。如果以后有其它业务，业务名另行分配。“IP直通车”业务服务名：IPDCB2.2.1.4会话头(18Byte)会话是接入SMP的”IP直通车”营帐系统与SMP之间的一个虚拟连接(逻辑连接)，唯一标识”IP直通车”营帐系统到SMP的一次有效登录。会话由”IP直通车”营帐系统主动发起创建，使用会话ID作为标识，在同一个SOCKET连接上的待登录的会话ID不能重复。当”IP直通车”营帐系统登录到SMP时，由”IP直通车”营帐系统先将会话ID置为0（可以不填），正式的会话ID由SMP生成并在第一个ACK消息中返回。“IP直通车”营帐系统与SMP在建立SOCKET连接之后，可以在此连接上创建一到多个会话。如要在新创建的会话上发送MML命令，必须执行登录命令并且在SMP返回登录成功的消息之后，此会话才可被使用。在不再需要此会话时，必须执行退出登录命令，以通知SMP清除此会话的信息。会话头包含会话ID，会话控制字和保留三个部分：会话ID：16进制字符(0-F)表示的32位整数(8B)，从1开始。会话ID由SMP分配，用于唯一标识一个由”IP直通车”营帐系统发起的会话，不同的会话有不同的ID值并且不等于0。在”IP直通车”营帐系统前置机一端，根据TCP连接(物理连接)和会话(逻辑连接)ID两者唯一确定消息发送的通道。会话控制字：6个八位位组的字符串(6B)。4会话控制字的编码如下：DlgLgn：请求登录DlgCon：会话保持DlgEnd：会话结束保留：4Byte保留：用做今后业务扩展用（4B）。2.2.1.5事务头(18Byte)事务是接入SMP的”IP直通车”营帐系统与SMP之间的一次交易。一次交易可以由一到多个功能命令组成(可以在一到多条消息中)，交易的结果也可以通过一到多个应答消息返回。事务必定归属于某个会话。“IP直通车”营帐系统可以通过可用的会话向SMP发送消息，以执行各种操作完成业务管理的功能，根据一个单一功能所需的功能命令和应答的个数可以将操作分成四类：单命令单返回、单命令多返回、多命令单返回、多命令多返回。由于SMP具有同时执行多个操作的能力，”IP直通车”营帐系统可以连续发送多批命令(命令可为以上四种操作中的任意组合)，然后等待执行结果的返回。为了标识不同操作(每一次操作的整个过程可看作一次交易)之间的功能命令与应答消息，使用事务ID来进行标识。事务ID由”IP直通车”营帐系统管理，必须保证在同一个会话中仍未结束的事务ID不重复。事务头由以下部分组成：事务ID：16进制字符(0-F)表示的32位整数(8B)，从1开始。事务ID由综合业务中心自行分配，用来标识一个事务，在同一会话中不同的事务必须有不同的ID值并且不等于0。事务控制字：6个八位位组的字符串(6B)。TxBeg：开始事务TxCon：事务继续TxEnd：事务结束保留：4Byte保留：用做今后业务扩展用（4B）。SMP应对事务操作的结果保留7天。2.2.1.6操作信息操作信息的内容为功能命令，功能命令见第三节。如果功能命令的长度不是4的倍数，则在后面填充空格补齐。会话ID会话控制字保留比特发送顺序事务ID事务控制字保留比特发送顺序52.2.1.7校验和(8Byte)16进制字符(0-F)表示的32位整数(8B)。校验和的算法如下：对“消息头＋会话头＋事务头＋操作信息”按32位异或，对异或结果取反后的值为校验和。当对接口进行测试时，SMP应该可以关闭校验和检查的功能。2.2.2心跳消息的编码心跳消息的消息开始标志和校验和的内容与接口协议的业务消息一样，消息长度值为4。填充内容为字符串：HBHB。中兴“IP直通车”营帐服务器每120秒将发送心跳消息于远端客户机。三次心跳消息接收不到视为连接中断。2.2.3超时判断在”IP直通车”营帐系统向SMP发送一条应该有响应的命令以后，SMP必须在10分钟内向”IP直通车”营帐系统发送ACK消息。如果响应分多条ACK发送，则其它ACK也应以小于10分钟的间隔继续发送直至事务结束。如果超出10分钟后，”IP直通车”营帐系统仍未收到ACK消息则认为SMP超时。三、接口定义１、会话头typedefstruct{bytesessionid[8];//会话IDcharctrlflag[6];//会话控制字charreserved[4];//保留}SessionHeadStruc;//会话头结构2、事务头typedefstruct{bytetransid[8];//事务IDcharctrlflag[6];//事务控制字charreserved[4];//保留}TransactionHeadStruc;//事务头3、消息头信息typedefstruct{charmsgflag[4];//消息开始标志intmsglen;//消息长度charmsghead[20];//消息头SessionHeadStrucsessionhead;//会话头6TransactionHeadStrucTransactionHead;//事务头}IPDCBMsgHead;//消息头信息//以下为功能命令结构信息4、手机开户typedefstruct{intareacode;//区号characcountno[12];//手机号码charusername[20];//手机用户姓名}AddMobileTel_T;//手机开户5、手机销户typedefstruct{characcountno[12];//手机号码}DelMobileTel_T;//手机销户6、绑定电话开户typedefstruct{charteleno[14];//绑定电话号码characcountno[12];//手机号码charpassword[6];//用户帐号密码1-6位数字组成，空则为无密码}AddUser_T;//绑定电话开户7、绑定电话销户typedefstruct{charteleno[14];//绑定电话号码}DelUser_T;//绑定电话销户8、手机激活/去激活typedefstruct{characcountno[12];//手机号码BYTEflag;//激活/去激活标志0-激活1-去激活}SetActiMobiTel_T;//手机激活/去激活9、绑定电话停/复机typedefstruct{charteleno[14];//绑定电话号码BYTEflag;//停/复机标志0-停机1-复机7}StopResuUser_T;//绑定电话停/复机10、修改/取消绑定电话密码typedefstruct{charteleno[14];//绑定电话号码BYTEflag;//修改/取消绑定电话密码标志0-修改密码1-取消密码charoldpwd[6];//原用户帐号密码charnewpwd[6];//新用户帐号密码}ModiUserPwd_T;//修改绑定电话密码11、开通/禁拨绑定电话国际长途typedefstruct{charteleno[14];//绑定电话号码BYTEflag;//开通/禁拨国际长途标志0-开通1-禁拨}ModiNationPriv_T;//开通/禁拨绑定电话国际长途12、设置/取消绑定电话禁拨号码typedefstruct{charteleno[14];//绑定电话号码BYTEflag;//设置/取消命令标志0-设置1-取消charbarringno[12];//禁拨号码}SetBarringTel_T;//设置/取消绑定电话禁拨号码13、查询绑定电话信息typedefstruct{charteleno[14];//绑定电话号码}QryUserInf_T;//查询绑定电话信息//操作信息14、操作信息typedefstruct{BYTEcommflag;//客户请求命令标志union{AddMobileTel_TaddMobiTel;DelMobileTe