息中心营帐受理接口的说明[电信版].docVIP

中兴通讯短消息中心营帐受理接口说明 （电信版） 说明： 本文档定义了短消息中心和营帐系统间的用户信息受理接口。接口遵循《中国电信CDMA短消息中心设备规范》。 营帐系统与短消息中心之间为TCP/IP连接，本规范定义了两种接口方式：消息接口和文件接口，推荐使用消息接口方式进行业务受理。 数据定义 数据类型定义 类型名称对应标准C语言类型字节数说明WORDunsigned short2BYTEunsigned char1BYTEiunsigned char[i]IDWORDunsigned long4INTInt4CHARChar1CHARichar[i]I用CHAR数组表示的字符串，必须以0字符或（NULL）结尾字节序定义 本接口所定义的数据在网络中传输时，采用标准网络字节序（Big-Endian）。 消息头（Message Head）定义 单元长度类型说明Command ID2WORD定义本条消息所对应的操作，见1.4Command Length2WORD消息长度Client Node2WORD由短消息厂家分配。 短消息中心可以不处理。 （默认为201，要求客户端可配置）Server Process2WORD由短消息厂家分配。 短消息中心可以不处理此字段。 （默认为210，要求客户端可配置）各类操作的消息头定义 操作Command ID开户/请求11005开户/响应11010查询用户/请求11015查询用户/响应11020修改用户/请求11025修改用户/响应11030销户/请求11035销户/响应11040 接口说明 消息接口 营帐系统与短消息中心之间通过异步Socket通信。短消息中心作为服务器端，提供以下IP供营帐系统连接： ，侦听端口为3000。营帐作为客户端bind到短消息中心，和短消息中心进行受理消息的交互。 以下接口的请求消息方向皆为营帐－SMSC，响应消息的方向为SMSC－营帐。 开户 请求 单元长度类型说明Message Head8参见1.3中定义。必填。Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号。必填。Sub MDN10BYTEi用BCD编码的用户MDN。必填。Sub MIN5BYTEi用BCD编码的用户MIN。必填。如果是空MIN，此5字节必须填全0xFFSub type1BYTE用户优先级： 数值0表示普通优先级； 数值1表示高优先级 必填。Sub language1BYTE语言类型： 0:English 1:Simplified Chinese 其他：保留 必填。Sub service32BYTEi业务鉴权信息 1、第1个字节表示网内点对点业务鉴权(数值1表示业务允许；数值0表示业务禁止)。 第12个字节表示网间互通点对点业务鉴权（数值1表示业务允许；数值0表示业务禁止） 2、其他字节保留，供以后新增的其他直连短消息中心的应用扩展使用 必填。 注：如果业务被禁止，则不能发消息，也不能收消息Time20CHARi 开户时间，格式如下： “YYYY-MM-DD HH:MM:SS” 必填。Tsp4DWORD当前操作时间戳 对营帐要求： 对同一个用户的开户和修改操作，填写操作时间戳，时间戳为顺序递增的。（如对某一个用户A） 第一次操作：A用户开户设置初始时间戳为1。 第二次操作：修改用户A信息时间戳（2）必须大于1。 第三次操作：修改用户A信息时间戳（3）必须大于2。 对短消息中心要求： 短消息中心可以不处理此字段PPFlag1BYTE预付费标记： 0：非预付费用户 1：预付费用户 必填。OCS21CHARiOCS号码，可以为空。 响应 单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Command Result2WORD操作结果， 0－成功； 非0－见3.1 查询用户 请求 单元长度类型说明Message Head8参见1.3中定义Sequence No.4 DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Sub MDN10BYTEi用BCD编码的用户MDNSub MIN5BYTEi用BCD编码的用户