中国电信SMGP协议

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

参数名 nNeedReport nMsgLevel sServiceID nMsgFormat sFeeType sFeeCode sFixedfee sValidTime sAtTime sSrcTermID sChargeTermID 数据类型 说明 Int Int Char(11) Int Char(3) Char(7) Char(7) Char(18) Char(18) Char(22) Char(22) 是否要求返回状态报告（0=不要求，1=要求） 优先级别，（0－9，0表示最低优先级） 业务代码 短消息格式（参照短消息格式表）。网关不做判定, 透明传输。 资费类别 资费代码（以分为单位） 包月费/封顶费（以分为单位） 存活有效期，格式遵循SMPP3.3协议 定时发送时间，格式遵循SMPP3.3协议 短消息发送用户号码（当为SP代码时须在前面加118） 计费号码（若为空，则对被叫计费） sDestTermIDFile Char(100) 保存所有目的号码的文件名 nMsgLen sMsgContent sMsgIDFile sMsgType Int Char(*) 消息长度 短消息内容（nMsgLen=0时表示存放短消息的文件名） Char(100) 保存所有短消息的返回MsgID和ErrorCode的文件名 Char(2) Char(9) 短消息类型 保留 sReserved

? 返回

0=成功 1=失败

A.3.4获取群发短消息的结果（GetSendBatchResp）

? 作用

从文件里读取群发的某一个短消息的标识、发送结果和发送号码。 ? 参数 参数名 sMsgIDFile nPos 数据类型 说明 Char(100) 保存所有短消息的返回MsgID和ErrorCode的文件名 Int 短消息位置，从0开始 - 55 -

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

pSendBatchResp ? 返回

SendBatchResp * 用于保存结果的SendBatchResp结构指针 0=成功 1=失败

A.3.5接收短消息（SMGPDeliver）

? 作用

连接短消息网关，等待接收属于本SP的短消息。 ? 参数 参数名 nTimeout pDeliverResp 数据类型 说明 Int* DeliverResp * 等待时间，单位：秒。0表示永远等待。 保存短消息的DeliverResp结构指针 ? 返回

0=成功 1=失败

A.3.6检查短消息网关是否能够提供服务（CMMPActiveTest）

? 作用

检查短消息网关是否能够提供服务。 ? 参数 参数名 nErrorCode ? 返回

数据类型 说明 Int 错误代码（参照错误代码表）。 0=成功 1=失败

- 56 -

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

A 3.7查询短消息流量（SMGPQuery可选）

? 作用

向短消息网关查询某天的短消息流量。 ? 参数 参数名 sDate nQueryType sServiceID pQueryResp ? 返回

数据类型 Char(10) Int Char(11) QueryResp * 说明 查询日期，格式：yyyymmdd 查询类型，0=总数查询；1=按业务代码查询 查询码1(业务类型) 保存查询结果的QueryResp结构指针 0=成功 1=失败

A.4配置SMGP API

配置文件在smgpapi/config/smgpc.ini，以下是配置项的说明： 名称 SPId SPShareKey WithPrevPage 说明 SP编号，必须与License的一致。 SP的密码，如果填写不正确会导致应用程序不能通过SMGP用户认证。 第1个以后的分割短消息的前置说明文字，可以为空。 例如（第2个分割短消息）：(2/3)(continue)xxxxxx “(continue)”是前置说明文字 WithNextPage 分割短消息的后置说明文字，可以为空，最后一个短消息不带后置说明文字。 例如（第1个分割短消息）：(1/3)xxxxxx(to be continued) “(to be continued)”是前置说明文字

- 57 -

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

PageSpaceAscii PageSpaceGB PageSpaceBinary WithPageIndex MaxPage ClientIP AscII短消息的最大长度 中文短消息的最大长度 二进制短消息的最大长度 在分割短消息时是否附加页号，0=否，1=是。 最大分割页数，最大是99页。 客户主机的IP地址，必须填写接入Internet的公网地址。如果主机是通过Gateway接入Internet，就填写Gateway地址。如果客户主机的IP地址填写错误会导致应用程序不能通过SMGP用户认证。 短消息网关的IP地址 短消息网关的端口 发送短消息自动重试次数（1表示只发送1次，不重新发送） 发送请求超时时间，单位：秒 ServerIP ServerPort SubmitRetry RequestTimeout

A.5短消息的自动分割功能

SMGPSendSingle和SMGPSendBatch提供自动分割短消息的功能，分割的效果由smgpc.ini的配置控制。

当参数nMsgFormat等于0或15时，API就提供分割短消息功能。API扫描短消息的内容，把短消息分段，根据每一段的短消息内容设置nMsgFormat。如果某一段短消息含有中文，就把那一段短消息的发送格式设为15，取PageSpaceGB为最大长度；如果不含中文，就把那一段短消息的发送格式设为0，取PageSpaceAscii为最大长度。这样，可以充分利用短消息的最大发送长度，减少分割数量。如果WithPrevPage或者PageSpaceGB含有汉字，所有分割短消息的发送格式都设为15。

当参数nMsgFormat等于4时，API根据PageSpaceBinary配置分割短消息。

当参数nMsgFormat等于0并且长度小于PageSpaceGB，API扫描短消息内容是否含有中文。如果发现中文，就自动把发送格式变为15。

- 58 -