短信平台接口说明

《短信平台接口说明》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、短信平台接口说明Version3.614目录1普通短信发送41.1短信提交地址41.2参数定义41.3短信提交响应51.3.1格式说明51.3.2示例51.3.3响应状态值说明61.4注意事项61.5短信发送例子72变量短信发送72.1系统提交URL地址72.2参数定义72.3提交响应82.3.1提交成功82.3.2提交失败92.3.3响应状态值说明92.4示例93短信包发送93.1系统提交URL地址93.2参数定义103.3提交响应103.3.1提交成功103.3.2提交失败113.3.3响应状态值说明113.4示例114状态报告推送114.1参数定义124.2状态报告

2、值124.3示例125短信接收135.1参数定义135.2示例136额度查询接口136.1接口地址136.2参数定义136.3提交响应146.4提交响应值146.5示例147附录1414版本修订历史项目日期修订内容备注12012-09-27修订章节结构，整理章节逻辑22012-11-25增加提交短信的参数product的定义及返回值的增加。1.1及1.2.3和1.432013-01-10增加扩展码1.142013-01-10增加变量短信提交调整章节结构，增加调整后的章节252013-01-315.1，增加MO目的号码62013-01-31增加3，包发送方式72013-03

3、-03增加查询额度的接口调整章节结构，增加调整后章节6，原来章节6及其后依次增加14本文档主要定了短信平台对用户开放的主要接口和定义。1普通短信发送用户通过HTTP的POST方式提交短信发送请求。短信发送接口，区分为短信单发和短信群发两个接口。1.1短信提交地址短信提交分为单发和群发（账户是否具有单发和群发的功能需要管理员进行功能的开通）。单发只能提交单个手机号码，群发可以提交不超过50000个手机号码，每个号码用英文逗号间隔。区别单发和群发主要在于发送的接口URL地址入口不同。单发的URL地址为：http://IP:PORT/msg/HttpSendSM，群发的URL地

4、址为：http://IP:PORT/msg/HttpBatchSendSM。注：其中IP:PORT为服务部署的地址和端口。1.2参数定义序号参数说明1account必填参数。用户账号2pswd必填参数。用户密码3mobile必填参数。合法的手机号码，号码间用英文逗号分隔4msg必填参数。短信内容，短信内容长度不能超过585个字符。使用URL方式编码为UTF-8格式。短信内容超过70个字符（企信通是60个字符）时，会被拆分成多条，然后以长短信的格式发送。5needstatus必填参数。是否需要状态报告，取值true或false，true，表明需要状态报告；false不需要状

5、态报告6product可选参数。用户订购的产品id，不填写（针对老用户）14系统采用用户的默认产品，用户订购多个产品时必填，否则会发生计费错误。7extno可选参数，扩展码，用户定义扩展码，3位1.1短信提交响应用户短信通过http请求提交到服务器后，服务器返回响应码，响应码的格式如下：resptime,respstatusmsgid1.1.1格式说明短信提交响应分为两行，第一行为响应时间和状态，第二行为服务器给出提交msgid。无论发送的号码是多少，一个发送请求只返回一个msgid，如果响应的状态不是“0”，则没有msgid即第二行数据。（每行以换行符(0x0a,即

6、)分割）1.1.2示例Ø提交成功20110725160412,01234567890100响应时间为20110725160412，响应状态为0表明那个成功提交到服务器；123456789010014为返回的msgid，这个工状态报告匹配时使用。20110725160412,101Ø提交失败Ø本示例表明用户提交失败，返回错误码为101，服务器端并未返回msgid。1.1.1响应状态值说明代码说明0提交成功101无此用户102密码错103提交过快（提交速度超过流速限制）104系统忙（因平台侧原因，暂时无法处理提交的短信）105敏感短信（短信内容包含敏感词）106消息长度错（>

7、536或<=0）107包含错误的手机号码108手机号码个数错（群发>50000或<=0;单发>200或<=0）109无发送额度（该用户可用短信数已使用完）110不在发送时间内111超出该账户当月发送额度限制112无此产品，用户没有订购该产品113extno格式错（非数字或者长度不对）1.2注意事项用户群发短信如果有审核的限制，则客户的短信必须经过管理人员的审核，审核通过后才能被提交到行业网关进行短信实际发送。14用户群发短信必须满足手机号码最低个数的限制，低于系统设定的群发最小手机号码数，则该提交请求会被拒绝，响应码为108。