短信平台接口规范

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

1、短信平台接口说明17目录1普通短信发送41.1接口地址41.2参数定义41.3短信提交响应51.3.1文本格式说明51.3.2JSON格式说明61.3.3响应状态值说明61.4注意事项71.5短信发送例子72变量短信发送72.1接口地址82.2参数定义82.3提交响应92.3.1文本格式说明92.3.2JSON格式说明92.3.3响应状态值说明102.4示例103短信包发送103.1接口地址103.2参数定义103.3提交响应113.3.1文本格式说明113.3.2JSON格式说明123.3.3响应状态值说

2、明123.4示例124状态报告推送134.1参数定义134.2状态报告值134.3示例145状态报告批量推送145.1参数定义145.2示例156短信接收156.1参数定义156.2示例157额度查询接口167.1接口地址167.2参数定义167.3提交响应16177.4提交响应值167.5示例178附录1717本文档主要定了短信平台对用户开放的主要接口和定义。1普通短信发送用户通过HTTP的POST方式提交短信发送请求。短信发送接口，区分为短信单发和短信群发两个接口。建议都使用群发接口1.1接口地址短信提

3、交分为单发和群发（账户是否具有单发和群发的功能需要管理员进行功能的开通）。单发只能提交单个手机号码，群发可以提交不超过50000个手机号码，每个号码用英文逗号间隔。区别单发和群发主要在于发送的接口URL地址入口不同。群发的URL地址为：http://116.62.205.143:80/msg/HttpBatchSendSM。注：其中IP:PORT为服务部署的地址和端口。1.2参数定义序号参数说明1account必填参数。用户账号2ts可选参数，时间戳，格式yyyyMMddHHmmss3pswd必填参数。用户

4、密码，ts参数为空时填明文密码，ts参数不为空时填md5(账号+密码+时间戳)，对账号密码时间戳拼接的字符串进行md5加密4mobile必填参数。合法的手机号码，号码间用英文逗号分隔5msg必填参数。短信内容，长度不能超过700个字符。使用URL方式编码为UTF-8格式。短信内容超过70个字符时，会被拆分成多条，然后以长短信的格式发送。6needstatus必填参数。是否需要状态报告，取值true或false，true，表明需要状态报告；false不需要状态报告7product17可选参数。用户订购的产品i

5、d，不填写时使用用户的默认产品，用户订购多个产品时必填，否则会发生计费错误。8extno可选参数，扩展码，用户自定义扩展码9resptype可选参数，响应格式，默认返回文本格式，填json返回json格式1.1短信提交响应用户短信通过http请求提交到服务器后，服务器返回响应1.1.1文本格式说明格式如下resptime,respstatusmsgid短信提交响应分为两行（每行以换行符(0x0a,即)分割），第一行为响应时间和状态，第二行为服务器给出提交msgid，一个发送请求只返回一个msgid。如果

6、响应的状态不是“0”，或者提交时needstatus不等于true，则没有msgid，即第二行数据为空。Ø提交成功20110725160412,01234567890100响应时间为20110725160412，响应状态为0表明成功提交到服务器；1234567890100为返回的msgid，供状态报告匹配时使用。Ø提交失败20110725160412,10117本示例表明用户提交失败，返回错误码为101，服务器端并未返回msgid。1.1.1JSON格式说明{"ts":"20110725160412","r

7、esult":0,"msgid":"1234567890100"}ts为响应时间，result为响应状态（0表示成功，其他表示失败），msgid为状态匹配使用（如果响应的状态不是0，或者提交时needstatus不等于true，则没有msgid字段）1.1.2响应状态值说明代码说明0提交成功101无此用户102密码错103提交过快（提交速度超过流速限制）104系统忙（因平台侧原因，暂时无法处理提交的短信）105敏感短信（短信内容包含敏感词）106消息长度错（>700或<=0）107包含错误的手机号码108手

8、机号码个数错（群发>50000或<=0;单发>200或<=0）109无发送额度（该用户可用短信数已使用完）110不在发送时间内111超出该账户当月发送额度限制112无此产品，用户没有订购该产品113extno格式错（非数字或者长度不对）115自动审核驳回116签名不合法，未带签名（用户必须带签名的前提下）11717IP地址认证错,请求调用的IP地址不是系统登记的IP地址118用户没有相应的发送权限119用户已过期