中国电信SMGP协议 下载本文

短消息网关协议SN RC1 SMGP V3.0.2

流水号字段由请求包发起方分配,取值范围为0x00000000-0xFFFFFFFF,顺序累加,步长为1,循环使用。

6.2 消息体必选参数描述

6.2.1 ClientID

客户端用来登录服务器端的用户账号。

当客户端为SP时,用户帐号为SP服务代码;当客户端为SMGW时,用户帐号为SMGW代码;当客户端为GNS时,用户帐号为GNS代码。

6.2.2 AuthenticatorClient

客户端认证码,用来鉴别客户端的合法性。 其值通过单向MD5 hash计算得出,表示如下:

AuthenticatorClient =MD5(ClientID+7 字节的二进制0(0x00) + Shared secret+Timestamp) Shared secret 由服务器端与客户端事先商定,最长15字节。

此处Timestamp格式为:MMDDHHMMSS(月日时分秒),经TimeStamp字段值转换成字符串,转换后右对齐,左补0x30得到。

例如3月1日0时0分0秒,TimeStamp字段值为0x11F0E540,此处为0301000000。

6.2.3 LoginMode

客户端用来登录服务器端的登录模式。 0=发送短消息(send mode); 1=接收短消息(receive mode); 2=收发短消息(transmit mode); 其它保留。

- 27 -

短消息网关协议SN RC1 SMGP V3.0.2

6.2.4 TimeStamp

时间戳。

例如3月1日0时0分0秒,用于MD5计算时为0301000000,此处转换为整型数即为11F0E540。

6.2.5 ClientVersion

客户端支持的协议版本号。

高4bit表示主版本号,低4bit表示次版本号。 例如0x13,表示协议版本号为1.3。

6.2.6 Status

请求返回结果。响应包用来向请求包返回成功信息或者失败原因。 SMGP协议的结果码定义如下: 代码 0 1 2 3-9 10 11 12 13-19 20 21 22 23-29 30 31 32 33 含义 成功 系统忙 超过最大连接数 保留 消息结构错 命令字错 序列号重复 保留 IP地址错 认证错 版本太高 保留 非法消息类型(MsgType) 非法优先级(Priority) 非法资费类型(FeeType) 非法资费代码(FeeCode) - 28 -

短消息网关协议SN RC1 SMGP V3.0.2

34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50~55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 非法短消息格式(MsgFormat) 非法时间格式 非法短消息长度(MsgLength) 有效期已过 非法查询类别(QueryType) 路由错误 非法包月费/封顶费(FixedFee) 非法更新类型(UpdateType) 非法路由编号(RouteId) 非法服务代码(ServiceId) 非法有效期(ValidTime) 非法定时发送时间(AtTime) 非法发送用户号码(SrcTermId) 非法接收用户号码(DestTermId) 非法计费用户号码(ChargeTermId) 非法SP服务代码(SPCode) 其它用途 非法源网关代码(SrcGatewayID) 非法查询号码(QueryTermID) 没有匹配路由 非法SP类型(SPType) 非法上一条路由编号(LastRouteID) 非法路由类型(RouteType) 非法目标网关代码(DestGatewayID) 非法目标网关IP(DestGatewayIP) 非法目标网关端口(DestGatewayPort) 非法路由号码段(TermRangeID) 非法终端所属省代码(ProvinceCode) 非法用户类型(UserType) 本节点不支持路由更新 非法SP企业代码(SPID) 非法SP接入类型(SPAccessType) 路由信息更新失败 非法时间戳(Time) - 29 -

短消息网关协议SN RC1 SMGP V3.0.2

73 74 75 76 112~116 128-255 其它 非法业务代码(MServiceID) SP禁止下发时段 SP发送超过日流量 SP帐号过有效期 其它用途 厂家自定义 保留 6.2.7 AuthenticatorServer

Login服务器端返回给客户端的认证码,当客户端认证出错时,此项为空。 其值通过单向MD5 hash计算得出,表示如下:

AuthenticatorServer =MD5(Status+AuthenticatorClient + Shared secret)

Shared secret 由服务器端与客户端事先商定,最长15字节AuthenticatorClient为客户端发送给服务器端的Login中的值。参见6.2.2节。

6.2.8 ServerVersion

服务器端支持的最高版本号。

高4bit表示主版本号,低4bit表示次版本号。 例如0x13,表示协议版本号1.3。

6.2.9 MsgType

短消息类型。

对于回执消息该字段无效;对于文本短消息,该字段表示短消息的消息流向: 0=MO消息(终端发给SP);

6=MT消息(SP发给终端,包括WEB上发送的点对点短消息); 7=点对点短消息; 其它保留。

- 30 -