资源描述
基于固定电话网的信息终端及综合信息系统平台技术规范 第七分册
中国电信集团公司企业标准
CT/T 1-2001
基于固定电话网的信息终端及综合信息系统技术规范
第七分册 短消息网关(SMGP)协议 V1.3
2002-04-30发布 2002-04-30实施
中国电信集团公司 发布
目 录
前 言 3
1 适用范围 4
2 引用标准 4
3 缩略语 4
4 SMGP概述 4
4.1. SMGP功能 4
4.2. SMGP定义 4
4.3. SMGP通信流程 5
5 SMGP数据包定义 7
5.1. 数据包结构 7
5.2. 请求标识说明 7
5.3. 包体结构 8
6 编码说明 16
6.1. 短消息格式代码表 16
6.2. 收费类型代码表 16
6.3. 短消息状态表 16
6.4. Err错误代码表 17
6.5. Status错误代码表 17
7 基于SMGP协议的API函数 18
附录A 基于SMGP协议的API函数说明 19
(提示的附录) 19
A.1基本要求 19
A.2 API数据结构说明(以C语言为例) 20
A.3 API函数说明 22
A 3.7查询短消息流量(SMGPQuery可选) 26
A.4配置SMGP API 26
A.5短信的自动分割功能 27
A.6错误代码含义 28
前 言
本标准介绍综合信息平台系统短消息网关和服务提供商内容提供商(SPCP)之间、短消息网关和短消息网关之间的通信协议。本协议简称SMGP(Short Message Gateway Protocol)。
本标准起草单位: 中国电信集团公司、中国电信集团公司上海研发中心
本标准主要起草人:
特别感谢:亚信科技中国有限公司在本协议制订过程中的大力支持和帮助。
第 2 页
1 适用范围
本协议适用于短消息网关开发商和短消息服务提供商内容提供商。
2 引用标准
SMPP (Short Message Peer to Peer Protocol Specification) v3.4 3
3 缩略语
见总册
4 SMGP概述
4.1. SMGP功能
网关通信SMGP协议是短消息服务提供商内容提供商与短消息网关,以及短消息网关与短消息网关之间的通信协议。SMGP可以实现以下功能:
(1) 服务提供商内容提供商向综合信息平台综合信息系统短消息用户发送短消息,例如邮件通知、天气预报等。
(2) 综合信息平台综合信息系统短消息用户向服务提供商内容提供商点播信息,例如查询股票查询信息、航班信息等。
(3) 服务提供商内容提供商以某个短消息用户的身份向综合信息平台综合信息系统短消息用户发送传情信息,例如图片传情、音乐传情等。
(4) 综合信息平台综合信息系统短消息用户发送的短消息通过短消息网关前转发送给异地的短消息用户。
4.2. SMGP定义
网关通信SMGP协议是一个基于数据包的交互式协议,底层通过TCP/IP协议传递数据。每个数据包都包含请求标识,代表数据包的用途。服务提供商内容提供商与短消息网关或者短消息网关与短消息网关之间采用cClient-/serverServer的方式交互信息,客户端向服务器端发送一个请求包,服务器端向客户端返回回应包。
客户端发送的所有请求包都包含一个唯一的序列号,服务器端返回的回应包也带有相应的序列号,以便客户识别这是哪一个请求的回应。
客户端和服务器端之间可以采用长连接或者短连接的方式通信。如果采用短连接,客户端必须以发送者、接收者或收发者的身份登录到服务器,通信完毕后断开连接。如果采用长连接,一旦认证通过建立连接,客户端与服务器端可以随时通信,在一定时间内两者之间没有发送合法的请求包,连接就中断。
4.3. SMGP通信流程
网关与ICPCP之间通信连接采用端口号8890,网关与网关通信连接采用端口号8900。
4.3.1. SMGP登录模式
在SMGP协议的一个会话中客户端可以采用三种登录方式与服务器端相连:发送模式(send mode)、接收模式(receive mode)和收发模式(transmit mode)。在发送模式中客户端只能发送短消息、在接收模式中客户端只能接收短消息、在收发模式中客户端即可既可以发送也可以接收短消息。三种模式均可以采用长连接与短连接两种连接方式的一种,根据实际情况选择。
4.3.2. SPCP发送短消息
SPCP以发送者或者是收发者身份登录后,就可以发送短消息。SPCP可以不等待上一个短消息发送回应包,就发送下一个短消息。
CP SMGW
login(send /transmit mode)
login_resp
submit(1)
submit(2)
submit_resp (1)
submit_resp (2)
exit
exit_resp
4.3.3. SPCP接收短消息
SPCP以接收者或者是收发者身份登录后,短消息网关就向SPCP下发MO发送短消息,短消息网关可以不等待上一个下发MO短消息回应包,就下发发送下一个MO短消息。
SPCP SMGW
login(receive /transmit mode)
login_resp
deliver(1)
deliver(2)
deliver_resp (1)
deliver_resp (2)
exit
exit_resp
4.3.4. SMGW转发短消息
短消息网关需要把异地MT/MO短消息转发到相应的短消息网关,在转发短消息之前短消息网关需要通过对方网关认证。
SPCP SMGW
longin(send /receive/ transmit mode)_
longin_resp
forward(1)
forward(2)
forward_resp (1)
forward_resp (2)
exit
exit_resp
5 SMGP数据包定义
SMGP基本数据类型定义如下表所示:
Integer
无符号整数
Octet String
定长字符串。位数不足时,如果左补‘0’则补ASCII表示的‘0’,如果右补‘0’则补二进制表示的‘0’
5.1. 数据包结构
SMGP数据包分为包头和包体两部分,包头的结构如下:
字段
长度(字节)
数据类型
说明
PacketLength
4
Integer
数据包长度(包头和包体的长度之和。单位:字节)
RequestID
4
Integer
请求标识
SequenceID
4
Integer
序列号(由客户端分配,循环递增)
5.2. 请求标识说明
请求标识(RequestID)标识数据包的类型,请求包的请求标识和回应包的请求标识一一对应。
请求名称
请求标识
说明
login
0x00000001
SPCP或SMGW登录请求
login_resp
0x80000001
SPCP或SMGW登录回应
submit
0x00000002
SPCP发送短消息请求
submit_resp
0x80000002
SPCP发送短消息回应
deliver
0x00000003
SMGW向SPCP发送短消息请求
deliver_resp
0x80000003
SMGW向SPCP发送短消息回应
active_test
0x00000004
测试通信链路是否正常请求(由客户端发起,SPCP和SMGW可以通过定时发送此请求来维持连接)
active_test_resp
0x80000004
测试通信链路是否正常回应
forward
0x00000005
SMGW转发MT/MO短消息请求
forward_reCP
0x80000005
SMGW转发MT/MO短消息回应
exit
0x00000006
退出请求
exit_resp
0x80000006
退出回应
query
0x00000007
CP发送短信状态统计查询请求
query_resp
0x80000007
CP短信状态统计查询结果回应
mt_route_update
0x00000008
MT路由更新请求
mt_route_update_resp
0x80000008
MT路由更新回应
mo_route_update
0x00000009
MO路由更新请求
mo_route_update_resp
0x80000009
MO路由更新回应
5.3. 包体结构
5.3.1. login
字段
长度
数据类型
说明
User
ClientID
118
Octet Stringstring
SPCP编号或者SMGW编号
编号规则参见总册第六6节
Password
AuthenticatorClient
1016
Octet String
客户端密码
用于鉴别客户端的接入请求 。其值通过单向MD5 hash计算得出,表示如下:
AuthenticatorClient =MD5(ClientID+7 字节的0 +shared secret+timestamp)
Shared secret 由中国电信服务器端与ICP客户端事先商定,timestamp格式为:MMDDHHMMSS,即月日时分秒,10位。
LoginMode
1
Integerinteger
登录类型(0=发送短消息, 1=接收短消息,2=转发收发短消息,其他保留)
TimeStamp
4
Integer
时间戳的明文,由客户端产生,格式为MMDDHHMMSS,即月日时分秒,10位数字的整型,右对齐
Version
1
integer
客户端支持的版本号(高位4bit表示主版本号,低位4bit表示次版本号)
5.3.2. login_resp
字段
长度(字节)
数据类型
说明
Result
Status
4
Integerinteger
login请求返回结果
(参照参见错误代码表)
AuthenticatorServer
16
Octet String
服务器端认证码,当客户端认证出错时,此项为空
其值通过单向MD5 hash计算得出,表示如下:
AuthenticatorServer =MD5(Status+AuthenticatorClient +shared secret)
Shared secret 由中国电信服务器端与ICP客户端事先商定,AuthenticatorICPClient为ICP客户端发送给SMGW服务器端的上一条消息login中的值。
+Version
1
Integer
服务器支持的最高版本号
5.3.3. submit
字段
长度(字节)
数据类型
说明
SubType
1
integer
短消息子类型(0=取消订阅,1=订阅请求,2=点播,3=订阅,其他保留)
NeedReport
1
integer
是否要求返回状态报告(0=不要求,1=要求)
Pk_id
10
Integer
多包短消息标识
Pk_total
1
Integer
相同Pk_id的消息总条数,从1开始
Pk_number
1
Integer
相同Pk_id的消息序号,从1开始
Priority
1
Integerinteger
发送优先级(从0到9)
ServiceID
10
Octet Stringstring
服务类型业务类型
FeeType
2
Octet Stringstring
收费类型(参照参见收费类型代码表)
FeeCode
6
Octet Stringstring
资费代码(单位为分)
MsgFormat
1
Octet Stringinteger
短消息格式(参照参见短消息格式代码表)
ValidTime
17
Octet Stringstring
有效时间,格式遵循SMPP3.3协议
AtTime
17
Octet Stringstring
定时发送时间,格式遵循SMPP3.3协议
SrcTermID
21
Octet String
短消息发送用户号码
作为短消息回执的目的地址
ChargeTermID
21
Octet Stringstring
计费用户号码
点播、订阅、传情等业务的使用用户号码
DestTermIDCount
1
Integerinteger
短消息接收号码总数(小等于≤100)
DestTermID
21* DestTerm Count
Octet Stringstring
短消息接收号码(连续存储DestTermIDCount个号码)
MsgLength
1
Integerinteger
短消息长度
MsgContent
≤小等于252
Octet Stringstring
短消息内容
Reserve
8
Octet String
保留
5.3.4. submit_resp
字段
长度(字节)
数据类型
说明
MsgID
10
Octet String
网关产生的短消息流水号,由三部分组成:
网关代码:3字节(BCD码)
时间:4字节(BCD码)
序列号:3字节(BCD码)
Result
Status
4
Integerinteger
Submit请求返回结果(参照参见错误代码表)
5.3.5. deliver
字段
长度(字节)
数据类型
说明
MsgID
1
Integer
网关产生的短消息流水号,由三部分组成:
网关代码:3字节(BCD码)
时间:4字节(BCD码)
序列号:3字节(BCD码)
IsReport
1
Integerinteger
是否状态报告(0=不是,1=是)
MsgFormat
1
Integerinteger
短消息格式(参照参见短消息格式代码表)
RecvTime
14
Octet Stringstring
短消息接收时间(格式:yyyymmddhhmiss,例如20010301200000)
SrcTermID
21
Octet Stringstring
短消息发送号码
DestTermID
21
Octet Stringstring
短消息接收号码
MsgLength
1
Integerinteger
短消息长度
MsgContent
≤小等于252
Octet Stringstring
短消息内容
Reserve
8
Octet String
保留
5.3.6. deliver_resp
字段
长度(长度)
数据类型
说明
MsgID
1
Integer
网关产生的短消息流水号,由三部分组成:
网关代码:3字节(BCD码)
时间:4字节(BCD码)
序列号:3字节(BCD码)
Result
Status
4
integer
Deliver请求返回结果(参照参见错误代码表)
5.3.7. active_test
没有包体
5.3.8. acitve_test_resp
没有包体
5.3.9. forward
字段
长度(长度)
数据类型
说明
MsgID
10
Octet String
网关产生的短消息流水号,由三部分组成:
网关代码:3字节(BCD码)
时间:4字节(BCD码)
序列号:3字节(BCD码)
DestSMGWNo
6
Octet Stringstring
目标网关代码
SrcSMGWNo
6
Octet Stringstring
源网关代码
SMCNo
6
Octet String
短消息中心代码
SMType
1
Integerinteger
短消息类型(0=MT,1=MO,2=异地点到点短消息,3=异网点到点短消息,其他保留)
SubType
1
integer
短消息子类型(0=取消订阅,1=订阅请求,2=点播,3=订阅,其他保留)
ReportFlag
1
Integerinteger
当SMType=0时,表示是否要求返回状态报告(0=不要求,1=要求)
当SMType=1时,表示是否状态报告(0=不是,1=是)
Pk_total
1
Integer
多包消息总条数,从1开始
Pk_number
1
Integer
多包消息序号,从1开始
Priority
1
Integerinteger
发送优先级(从0到9)
ServiceID
10
Octet Stringstring
服务类型业务类型
FeeType
2
Octet Stringstring
资费类型(参照参见收费类型代码表)
FeeCode
6
Octet Stringstring
资费代码(单位为分)
MsgFormat
1
Integerinteger
短消息格式(参照参见短消息格式代码表)
ValidTime
17
Octet Stringstring
有效时间,格式遵循SMPP3.3协议
AtTime
17
Octet Stringstring
定时发送时间,格式遵循SMPP3.3协议
SrcTermID
21
Octet String
短消息发送用户号码
DestTermID
21
Octet String
短消息接收用户号码
ChargeTermID
21
Octet String
计费用户号码
MsgLength
1
Integerinteger
短消息长度
MsgContent
≤小等于252
Octet Stringstring
短消息内容
Reserve
8
Octet String
保留
5.3.10. forword_resp
字段
长度(长度)
数据类型
说明
MsgID
10
Octet String
网关产生的短消息流水号
Pk_total
1
Integer
多包消息总条数,从1开始
Pk_number
1
Integer
多包消息序号,从1开始
Result
Status
4
Integerinteger
Forward请求返回结果(参照参见错误代码表)
5.3.11. exit
没有包体
5.3.12. exit_resp
没有包体
query(保留)
字段名
字节数
属性
描述
Time
8
Octet String
查询时间(格式:yyyymmdd,精确到日)
Query_Type
1
Integer
查询类别
0:总数查询
1:按业务代码查询
其他保留
Query_Code
10
Octet String
查询码当Query_Type为0时,此项无效;当Query_Type为1时,此项填写业务代码Service_id.
(业务类型)
query_resp (保留)
字段名
字节数
属性
描述
Time
8
Octet String
查询时间(格式:yyyymmdd,精确到日)
Query_Type
1
Integer
查询类别
0:总数查询
1:按业务代码查询
其他保留
Query_Code
10
Octet String
查询码(业务类型)
MT_TLMsg
4
Integer
从SP接收信息短消息总数
MT_Tlusr
4
Integer
从SP接收用户总数
MT_Scs
4
Integer
成功转发数量
MT_WT
4
Integer
待转发数量
MT_FL
4
Integer
转发失败数量
MO_Scs
4
Integer
向SP成功送达数量
MO_WT
4
Integer
向SP待送达数量
MO_FL
4
Integer
向SP送达失败数量
Reverse
8
Octet String
保留
mt_route_update (保留)
字段名
字节数
属性
描述
UpdateType
1
Integer
0 - 添加;1-删除;2-更新
其他保留
RouteId
4
Integer
路由编号(若update_type 为“添加”,则此字段为零)
SrcGatewayId
6
Octet String
源网关代码
SrcGatewayIP
15
Octet String
源网关IP地址
SrcGatewayPort
2
Integer
源网关IP端口
StartTermId
6
Octet String
MT路由起始号码段
EndTermId
6
Octet String
MT路由截止号码段
AreaCode
4
Octet String
终端所属区号
mt_route_update_resp (保留)
字段名
字节数
属性
描述
Status
1
Integer
参照参见错误代码表
mo_route_update(保留)
字段名
字节数
属性
描述
UpdateType
1
Integer
0 - 添加;1-删除;2-更新
其他保留
RouteId
4
Integer
路由编号(若update_type 为“添加”,则此字段为零)
SrcGatewayId
6
Octet String
源网关代码
SrcGatewayIP
15
Octet String
源网关IP地址
SrcGatewayPort
2
Integer
源网关IP端口
SrcTermID
21
Octet String
ICP代码
mo_route_update_resp(保留)
字段名
字节数
属性
描述
Status
1
Integer
参照参见错误代码表
5.3.13. 状态报告格式
字段
长度
数据类型
说明
MsgIDid
10
Octet Stringstring
短消息标识状态报告对应原短消息的MsgID
Submit_date
14
Octet Stringstring
短消息提交时间(格式:yyyymmddhhmiss,例如010331200000)
done_date
14
Octet Stringstring
短消息下发时间(格式:yyyymmddhhmiss,例如010331200000)
Status
7
Octet Stringstring
短消息状态(参照参见短消息状态表)
Err
3
Octet Stringstring
参见错误代码表
5.3.14. 修改密码格式
字段
长度
数据类型
说明
OldPassword
10
Octet Stringstring
旧密码
NewPassword
10
Octet Stringstring
新密码
6 编码说明
6.1. 短消息格式代码表
代码
含义
0
ASCII编码
3
短消息写卡操作
4
二进制短消息
8
UCS2编码
15
含GB汉字
6.2. 收费类型代码表
代码
含义
00
免费
01
按条收费
02
包月
03
封顶
其他
保留
短消息状态表
状态名
状态值(字符串)
说明
DELIVERED
DELIVRD
短消息转发成功
EXPIRED
EXPIRED
短消息超过有效期
DELETED
DELETED
短消息已经被删除
UNDELIVERABLE
UNDELIV
短消息是不可转发的
ACCEPTED
ACCEPTD
短消息已经被最终用户接收
(为保持与SMPP兼容,保留)
UNKNOWN
UNKNOWN
未知短消息状态
REJECTED
REJECTD
短消息被拒绝
(为保持与SMPP兼容,保留)
Err错误代码表
状态值(字符串)
说明
对应状态
command_status对应值
Command_status代码
000
成功
DELIVRD
ESME_ROK
0x00000001
001
用户不能通信
EXPIRED
ESME_RUSRABSENT
0x00000400
002
用户忙
EXPIRED
ESME_RUSRUSY
0x00000401
003
终端无此部件号
UNDELIV
ESME_RNOPART
0x00000402
004
非法用户
UNDELIV
ESME_RUSRINVALID
0x00000403
005
用户在黑名单内
UNDELIV
ESME_RBLACKLIST
0x00000404
006
系统错误
UNDELIV
ESME_RSYSERROR
0x00000405
007
用户内存满
EXPIRED
ESME_RMEMCAP
0x00000406
008
非信息终端
UNDELIV
ESME_PROTOCOLERROR
0x00000407
009
数据错误
UNDELIV
ESME_DATAERROR
0x00000408
010
数据丢失
UNDELIV
ESME_DATAMISSING
0x00000409
注:err错误代码的定义对应了SMPP协议包头中command_status字段的相应状态值。
6.3. Status错误代码表
代码
含义
0
成功
1
非法数据包系统忙
2
登录失败超过最大连接数
3-9
非法发送优先级保留
410
非法资费类型消息结构错
511
非法资费代码命令字错
612
非法短消息格式序列号重复
713-19
非法有效时间保留
820
非法定时发送时间IP地址错
921
非法短消息发送号码认证错
1022
非法短消息接收号码版本太高
1123-29
非法短消息长度保留
1230
非法目标网关代码非法消息类型(SMType)
1331
非法源网关代码优先级(Priority)
1432
非法转发短消息接收号码资费类型(FeeType)
1533
非法资费代码(FeeCode)修改密码失败
1634
保留非法短消息格式(MsgFormat)
35
非法时间格式
36
非法短消息长度(MsgLength)
37
有效期已过
38
非法查询类别(QueryType)
39
路由错误
40-127
保留
128-255
厂家自定义
7 基于SMGP协议的API函数
详见附录A。
附录A 基于SMGP协议的API函数说明
(提示的附录)
A.1基本要求
A.1.1安装
网关需要提供API软件包,解压到指定目录下后可以修改配置文件,配置参数至少包括IcpId(ICP编号)、IcpShareKey(ICP密码)、ClientIP(客户主机的IP地址)和ServerIP(短信网关地址)。
A.1.2例子程序
网关至少应该提供以下例程,供ICP调试使用,分别为:
Connect(参数),检查是否能够成功登录短消息网关;
TestAPI(参数),检查是否能够成功连接短信网关。
SetKey (参数),修改ICP密码。
SendSM(参数)尝试发送短信。
RecvSM(参数)尝试接收短信等。
RecvSMReport(参数),尝试接收短消息状态报告。
A.1.3操作系统平台要求
网关提供的API软件包至少要求支持以下操作系统平台:
Free BSD 3.x, 4.2
Solaris 5.6, 5.7, 5.8(包含x86)
Linux(Redhat和Slack等主流产品)
Windows NT/2000等
网关提供的API软件包至少要求支持以下编程语言:
C/C++
JAVA
A.2 API数据结构说明(以C语言为例)
A.2.1接收短信的返回数据结构(DeliverResp)
用途
保存SMGPDeliver函数返回的短信内容。
字段说明
字段名
数据类型
说明
sMsgID
Char(11)
短消息标识
nMsgFormat
Int
短消息格式(参照短消息格式代码表)。网关不做判定, 透明传输。
sSrcTermID
Char(22)
短消息发送用户号码
nIsReport
Int
是否为应答信息。代码含义:非应答信息(0);应答信息(1)
nMsgLen
Int
消息长度
sMsgContent
Char(201)
消息内容
sDestTermID
char(21)
CP的接入代码
sRecvTime
char(15)
短消息接收时间(格式:yyyymmddhhmiss,例如20010301200000)
A.2.2获取群发短信的返回数据结构(SendBatchResp)
用途
使用SMGPSendBatch群发短信后,每条短信的“消息标识”和“错误代码”保存在文件里。SMGP API提供GetSendBatchResp函数获取每一条短信返回信息,保存在SendBatchResp中。
字段说明
字段名
数据类型
说明
sMsgID
Char(11)
短消息标识
nErrorCode
Int
错误代码(参照错误代码表)
sPhoneNo
Char(22)
发送号码
A.2.3查询短消息网关的返回数据结构(QueryResp可选)
用途
保存SMGPQuery函数返回的查询结果。
字段说明
字段名
数据类型
说明
nMT_TLMsg
Int
接收短消息总数
nMT_TLusr
Int
接收用户总数
nMT_Scs
Int
成功转发数量
nMT_WT
Int
待转发数量
nMT_FL
Int
转发失败数量
nMO_Scs
Int
成功送达数量
nMO_WT
Int
待送达数量
nMO_FL
Int
送达失败数量
A.3 API函数说明
A.3.1初始化API(InitSMGPAPI)
作用
初始化SMGP API,应用程序只需要调用一次此函数。
参数
参数名
数据类型
说明
SiniFile
Char(100)
SMGPAPI配置文件名,缺省值是:”../config/smgpc.ini”。
如果应用程序的执行目录不在smgpapi/bin下,就需要通过绝对或相对路径指定sINIFile。
例如:InitSMGPAPI(“/opt/smgpapi/config/smgpc.ini”)
返回
0=成功
1=失败
A.3.2发送单条短信(SMGPSendSingle)
作用
向短消息网关发送1条短消息到1个终端用户。短消息长度最长为200, SMGP API在发送时自动建立Connection Pool,采用长连接或者短连接发送短消息。当Cache的connection中断时,API能够自动重新连接短消息网关。如果应用程序采用多线程发送短消息,多个线程共享同一个Connection Pool。在发送过程中,如果因为通信原因导致发送失败,API能够自动重新发送,重试的次数在配置文件设置。
参数
参数名
数据类型
说明
nNeedReport
Int
是否要求返回状态报告(0=不要求,1=要求)
nMsgLevel
Int
信息级别(0-9,0=最低优先级)
sServiceID
Char(11)
业务类型
nMsgFormat
Int
短消息格式(参照短消息格式表)。网关不做判定, 透明传输。
sFeeType
Char(3)
资费类别
sFeeCode
Char(7)
资费代码(以分为单位)
sValidTime
Char(18)
存活有效期,格式遵循SMPP3.3协议
sAtTime
Char(18)
定时发送时间,格式遵循SMPP3.3协议
sChargeTermID
Char(22)
计费号码
sDestTermID
Char(22)
短消息接收号码
nMsgLen
Int
短消息长度
sMsgContent
Char(*)?
短消息内容(nMsgLen=0时表示存放短消息的文件名)
sMsgID
Char(11)
返回的短消息标识
nErrorCode
Int
错误代码(参照错误代码表)。
返回
0=成功
1=失败
A.3.3群发短信(SMGPSendBatch)
作用
向短消息网关发送1条短消息到多个手机用户。短消息长度最长为200,此函数使用文件传递短消息内容。SMGP API在发送时自动建立Connection Pool,采用长连接或者短连接发送短消息。当Cache的connection中断时,API能够自动重新连接短消息网关。如果应用程序采用多线程发送短消息,多个线程共享同一个Connection Pool。在发送过程中,如果因为通信原因导致发送失败,API能够自动重新发送,重试的次数在配置文件设置。
参数
参数名
数据类型
说明
nNeedReport
int
是否要求返回状态报告(0=不要求,1=要求)
nMsgLevel
int
信息级别。(0=最低优先级,1=正常,2=紧急,3=十分紧急)
sServiceID
Char(11)
业务类型
nMsgFormat
Int
短消息格式(参照短消息格式表)。网关不做判定, 透明传输。
sFeeType
Char(3)
资费类别
sFeeCode
Char(7)
资费代码(以分为单位)
sValidTime
Char(18)
存活有效期,格式遵循SMPP3.3协议
sAtTime
Char(18)
定时发送时间,格式遵循SMPP3.3协议
sSrcTermID
Char(22)
短消息发送用户号码(当为CP代码时须在前面加118)
sChargeTermID
Char(22)
计费号码(若为空,则对被叫计费)
sDe
展开阅读全文