第3章 通信协议

SMIAS ICP接口v1.2完全向下兼容SMIAS ICP接口v1.1，使用v1.1协议格式仍然可以正常的和网关进行通信，但无法使用v1.2所提供的新特性。

§3.1 阅读说明

消息格式表格共有四项： 参数： 消息包中参数名称。

长度： 参数长度，以八位组(octet)为单位；关于长度说明参见表3-2。 类型： 参数的数据类型；请参见表3-1。

说明： 对此项参数的含义，去值范围，注意事项以及其他情况进行简要说明。

§3.1.1 数据类型 数据类型 Integer Bin C-Octet String C-Hex String C-Dec String Octet String Mixed 说明 无符号整数 定长二进制类型 变长字符串，以二进制0结尾 变长字符串，内容为ASCII (‘0’-‘9’,’a’-‘f’, ‘A’-‘F’)，以二进制0结尾 变长字符串，内容为ASCII (‘0’-‘9’)，以二进制0结尾 定长串 混合类型；表明此项由多种类型的不同参数组成 表 3-1 数据类型

§3.1.2 长度 形式 N (纯数字) Var. Max N M or N 说明 此参数定长，长度为N 此参数变长，最大长度为N 此参数定长，长度为M或N 表 3-2 长度说明

2-1

SMIAS短信网关系统ICP接口使用手册（ANSI C V2.1）

§3.2 协议包格式

消息域 Message Head Message Body 说明 消息头（对于不同的消息包，消息头的格式是固定的） 消息体（对于不同的消息包，消息体的格式是不尽相同） 表 3-3 SMIAS SP接口协议包格式

§3.3 消息头格式

参数 Packet length Packet command 长度 4 4 类型 Integer Integer 描述 消息总长度(含消息头及消息体) 命令值（参照表?） 范围0x00000000-0x000000FF被用于请求包 范围0x80000000-0x800000FF被用于应答包 应答包的命令值等于请求包的命令值相对应 命令状态 此参数仅在应答包中有效，其含义是说明其所应答的请求包的状态。状态码含义对应表请参照附录1 消息流水序号,顺序累加,步长为1，循环使用 其值的范围为1-0x7fffffff Command status 4 Integer Sequence number 4 Integer 表 3-4 SMIAS SP接口消息头格式

2-4

第2章 接口操作

§3.4 消息体格式

§3.4.1 Login 消息体 参数 SP ID 长度 SP AUTH SP bind type Var. Max 7 16 1 类型 C-Dec String Bin Integer 描述 ICP标志码 ICP认证码,使用MD5算法加密 用户登录类型 SMIAS 系统支持三种登录类型： 0--发送型 1--接收型 2--收发型 接口版本 其值的计算方法为： 主版本号*16+副版本号 例如：版本1.2的值为0x12 现在网关支持的值为0,0x11,0x12 如果值为0和0x11则声明以后的通信包格式仍然使用v1.1的格式,如果值为0x12，则声明以后的通信包格式使用v1.2的格式。 关于v1.1的格式请参考《SMIAS ICP接口手册(C-API v1.1)》 Login时间戳； 其值为从1970-01-01 GMT时间到SP此次Login的时间所流逝的秒数。 1I/F version 1 Integer Timestamp 4 Integer 表 3-5 SMIAS SP接口Login消息体格式

1

加密方法与CMPP v1.2相同 SP AUTH = MD5（SP ID + 9 字节的0 + shared secret + timestamp） 2-3

SMIAS短信网关系统ICP接口使用手册（ANSI C V2.1）

§3.4.2 Login Response消息体

参数 长度 类型 描述 Last I/F Version ISMG AUTH 1 16 Integer Bin 网关支持的最高版本 网关认证码2 如果Login请求失败，此项添为全二进制0 表 3-6 SMIAS SP接口Login Response消息体格式

§3.4.3 Logout 消息体

无消息体

§3.4.4 Logout Response消息体

无消息体

2

加密方法同CMPP v1.2 ISMG AUTH=MD5（Command Status + SP AUTH + shared secret） 2-4