中国联合通信公司短消息网关系统接口协议1.1版 4.1.4UserRpt操作
UserRpt命令用于在完成对用户鉴权后,由SMG向手机用户所注册的SP发送命令,对手机用户进行状态配置。
4.1.4.1UserRpt命令的请求内容
参数名称 CommandId SequenceNumber SPNumber UserNumber UserCondition Reserve 说明 命令ID,十六进制数字 序列号,十六进制数字 SP的接入号码,字符 待配置的手机号码,字符,手机号码前加“86”国别标志 十六进制数,0:注销;1:欠费停机;2:恢复正常 保留,扩展用 表4-8 UserRpt命令的请求格式
4.1.4.2UserRpt命令的应答内容
参数名称 CommandId SequenceNumber Result 命令ID,十六进制数字 序列号,十六进制数字 UserRpt命令执行结果 0:成功 其它:错误码 保留,扩展用 表4-9 UserRpt命令的应答格式
说明 Reserve 4.1.5Trace操作
Trace命令用于向SMG请求跟踪某一条MT短消息的状态。
4.1.5.1Trace命令的请求内容
参数名称 CommandId SequenceNumber SubmitSequenceNumber UserNumber Reserve 说明 命令ID,十六进制数字 序列号,十六进制数字 被跟踪MT短消息的命令序列号,十六进制数字 被跟踪MT短消息的目的手机号,字符,手机号码前加“86”国别标志 保留,扩展用 表4-10 Trace命令的请求格式
22
中国联合通信公司短消息网关系统接口协议1.1版 4.1.5.2Trace命令的应答内容
字段 CommandId SequenceNumber Count Result 说明 命令ID,十六进制数字 序列号,十六进制数字 被跟踪MT短消息经过的节点个数,当被跟踪短消息经过多个节点时,以下各个字段可重复 Trace命令在该节点是否成功接收。十六进制数字 0:接收成功 1:等待处理 其它:错误码 节点编号,字符 被跟踪的短消息到达该节点时刻,格式为“yymmddhhmmss” 该节点发出被跟踪的短消息时刻,格式为“yymmddhhmmss” 保留,扩展用,当被跟踪短消息经过多个节点时,以上各个字段可重复 表4-11 Trace命令的应答格式
NodeId ReceiveTime SendTime Reserve 4.2基于专用SGIP的消息定义
专用SGIP协议中定义的消息由消息头和消息体组成。 项目 消息头 消息体 消息头部分 消息体部分 表4-12消息的组成
说明 4.2.1数据类型
消息中利用到如下数据类型
类型 Integer Text 说明 无符号整数 定长字符串,左对齐存储,空余位置补’\\0’ 表4-13消息的数据类型
消息中的所有Integer类型的字段均采用网络字节顺序。所有消息中的序列号字段均占12个字节,分为3个4字节整数;通信传输时每个整数都使用网络字节顺序,但整数的次序并不改变。也就是说,通信传输的时候,序列号字段应该按照三个连续的4字节整数来处理。
23
中国联合通信公司短消息网关系统接口协议1.1版 4.2.2消息头的格式
字段 Message Length Command ID Sequence Number 长度(字节) 4 4 12 类型 Integer Integer Integer 说明 消息的总长度(字节) 命令ID 序列号 表4-14消息头的格式
4.2.3消息体的格式
4.2.3.1Bind操作
Bind操作由Bind命令和Bind_Resp应答组成。客户端首先发送Bind命令,服务器端收到Bind命令后,对命令发送方进行验证,然后返回Bind_Resp应答。
4.2.3.1.1Bind命令的语法
字段 Login Type 长度(字节) 1 类型 Integer 说明 登录类型。 1:SP向SMG建立的连接,用于发送命令 2:SMG向SP建立的连接,用于发送命令 3:SMG之间建立的连接,用于转发命令 4:SMG向GNS建立的连接,用于路由表的检索和维护 5:GNS向SMG建立的连接,用于路由表的更新 6:主备GNS之间建立的连接,用于主备路由表的一致性 11:SP与SMG以及SMG之间建立的测试连接,用于跟踪测试 其它:保留 服务器端给客户端分配的登录名 服务器端和Login Name对应的密码 保留,扩展用 Login Name Login Passowrd Reserve 16 16 8 Text Text Text 表4-15 Bind消息格式
注1:该 协议要求所有类型的socket连接建立之后,都需要有一个bind的过程。也就是说网关系统不仅要为各个SP,SMG以及GNS分配bind的Login name, Login password,以供各个SP,SMG,GNS可以作为client连接并bind到网关系统上,还要储存作为client连接并bind各个SP,SMG以及GNS所需的login name和login password。
24
中国联合通信公司短消息网关系统接口协议1.1版 4.2.3.1.2Bind_Resp应答的语法
字段 Result 长度(字节) 1 类型 Integer 说明 Bind执行命令是否成功。 0:执行成功 其它:错误码 保留,扩展用 Reserve 8 Text 表4-16 Bind_Resp消息格式
注:result中的“错误码”在37页有定义。
4.2.3.2Unbind操作
Unbind操作由Unbind命令和Unbind_Resp应答组成。通信连接建立以后,客户端如果要停止通信,需要发送Unbind命令;服务器端收到Unbind命令后,向客户端发送Unbind_Resp相应,然后双方断开连接。
4.2.3.2.1Unbind命令的语法
Unbind命令没有消息体。
4.2.3.2.2Unbind_Resp应答的语法
Unbind_Resp应答没有消息体。
4.2.3.3Submit操作
在SP和SMG的通信中,SP用Submit命令向SMG提交MT短消息,发送到用户的手机中。SMG接收到Submit命令,会返回Submit_Resp应答。SMG根据Submit命令中的付费号码,判断出该命令是否应从本地SMSC发送,如果属于本地发送,则直接发送到相应的SMSC,否则路由至相应的SMG。
在SMG和SMG的通信中,Submit命令用于SMG客户端向服务器端路由从SP收到的MT短消息。服务器端接收到Submit命令后,再发送到与之相连的目的SMSC。
25
中国联合通信公司短消息网关系统接口协议1.1版 4.2.3.3.1Submit命令的语法
字段 SPNumber ChargeNumber 长度(字节) 21 21 类型 Text Text 说明 SP的接入号码 付费号码,手机号码前加“86”国别标志;当且仅当群发且对用户收费时为空;如果为空,则该条短消息产生的费用由UserNumber代表的用户支付;如果为全零字符串“000000000000000000000”,表示该条短消息产生的费用由SP支付。 接收短消息的手机数量,取值范围1至100 接收该短消息的手机号,该字段重复UserCount指定的次数,手机号码前加“86”国别标志 … 企业代码,取值范围0-99999 业务代码,由SP定义 计费类型 取值范围0-99999,该条短消息的收费值,单位为分,由SP定义 对于包月制收费的用户,该值为月租费的值 取值范围0-99999,赠送用户的话费,单位为分,由SP定义,特指由SP向用户发送广告时的赠送话费 代收费标志,0:应收;1:实收 引起MT消息的原因 0-MO点播引起的第一条MT消息; 1-MO点播引起的非第一条MT消息; 2-非MO点播引起的MT消息; 3-系统反馈引起的MT消息。 优先级0-9从低到高,默认为0 短消息寿命的终止时间,如果为空,表示使用短消息中心的缺省值。时间内容为16个字符,格式为”yymmddhhmmsstnnp” ,其中“tnnp”取固定值“032+”,即默认系统为北京时间 短消息定时发送的时间,如果为空,表示立刻发送该短消息。时间内容为16个字符,格式为“yymmddhhmmsstnnp” ,其中“tnnp”取固定值“032+”,即默认系统为北京时间 状态报告标记 0-该条消息只有最后出错时要返回状态报告 1-该条消息无论最后是否成功都要返回状态报告 2-该条消息不需要返回状态报告 3-该条消息仅携带包月计费信息,不下发给用户,要返回状态报告 其它-保留 缺省设置为0 GSM协议类型。详细解释请参考GSM03.40中的9.2.3.9 GSM协议类型。详细解释请参考GSM03.40中的9.2.3.23,仅使用1位,右对齐 UserCount UserNumber … CorpId ServiceType FeeType FeeValue 1 21 … 5 10 1 6 Integer Text … Text Text Integer Text GivenValue 6 Text AgentFlag MorelatetoMTFlag 1 1 Integer Integer Priority ExpireTime 1 16 Integer Text ScheduleTime 16 Text ReportFlag 1 Integer TP_pid TP_udhi 1 1 Integer Integer
26