企业短信http接口文档2.0

《企业短信http接口文档2.0》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、企业短信HTTP接口文档2.0目录1普通短信发送31.1短信接口地址31.2参数定义31.3短信提交响应41.3.1格式说明41.3.2示例41.3.3响应状态值说明51.4注意事项61.5短信发送例子62状态报告推送62.1参数定义72.2状态报告值72.3示例73短信接收83.1参数定义83.2示例84额度查询接口94.1接口地址94.2参数定义94.3提交响应94.4提交响应值94.5示例105附录10本文档主要定了短信平台对用户开放的主要接口和定义。1短信发送用户通过HTTP的POST方式提交短信发送请求。短信发送接口如下。1.1短信接口地址接

2、口：http://send.18sms.com/msg/HttpBatchSendSM。1.2参数定义序号参数说明1account必填参数。用户账号2pswd必填参数。用户密码3mobile必填参数。合法的手机号码4msg必填参数。短信内容，验证码短信内容控制在70个字符内。使用URL方式编码为UTF-8格式。通知短信内容超过70个字符时，会被拆分成多条，然后以长短信的格式发送。5needstatus必填参数。是否需要状态报告，取值true或false，true，表明需要状态报告；false不需要状态报告6product可选参数。用户订购的产品id，不

3、填写（针对老用户）系统采用用户的默认产品，用户订购多个产品时必填，否则会发生计费错误。7extno请登陆网站用户中心——>服务管理找到签名对应的extno并填写，线下用户请为空。1.3短信提交响应用户短信通过http请求提交到服务器后，服务器返回响应码，响应码的格式如下：resptime,respstatusmsgid1.1.1格式说明短信提交响应分为两行，第一行为响应时间和状态，第二行为服务器给出提交msgid。无论发送的号码是多少，一个发送请求只返回一个msgid，如果响应的状态不是“0”，则没有msgid即第二行数据。（每行以换行符(0x0a,即

4、)分割）注：needstatus参数需要等于true才会返回msgid1.1.2示例Ø提交成功20110725160412,01234567890100响应时间为20110725160412，响应状态为0表明那个成功提交到服务器；1234567890100为返回的msgid，这个工状态报告匹配时使用。20110725160412,101Ø提交失败Ø本示例表明用户提交失败，返回错误码为101，服务器端并未返回msgid。1.1.1响应状态值说明代码说明0提交成功101无此用户102密码错103提交过快（提交速度超过流速限制）104系统忙（因平台侧原因

5、，暂时无法处理提交的短信）105敏感短信（短信内容包含敏感词）106消息长度错（>536或<=0）107包含错误的手机号码108手机号码个数错（群发>50000或<=0）109无发送额度（该用户可用短信数已使用完）110不在发送时间内(验证码通知7*24小时发送)111超出该账户当月发送额度限制112无此产品，用户没有订购该产品113extno格式错（非数字或者长度不对）115自动审核驳回116签名不合法，未带签名（用户必须带签名的前提下）117IP地址认证错,请求调用的IP地址不是系统登记的IP地址118用户没有相应的发送权限119用户已过期120内

6、容不在白名单中1.2注意事项用户发短信必须提前报备短信内容，如果发送未报备的内容会进入审核平台，则客户的短信必须经过管理人员的审核，审核通过后才能被提交到行业网关进行短信实际发送。用户群发短信必须满足手机号码最低个数的限制，低于系统设定的群发最小手机号码数，则该提交请求会被拒绝，响应码为108。1.1短信发送例子特别注意：请登陆网站用户中心——>服务管理找到签名对应的extno并填写，线下用户请为空。Ø短信发送http://send.18sms.com/msg/HttpBatchSendSM?account=003547&pswd=Sd123456&m

7、obile=15924188183&msg=您好，您的验证码：1234&needstatus=true&extno=2状态报告推送如果管理员设置用户账户需要状态报告，并且也配置了账户的状态报告接收地址，则用户可以接收到其发送短信的状态报告。用户侧启动一个HTTP服务用于接收状态报告。2.1参数定义序号参数说明1receiver接收状态报告验证的用户名（不是账户名），是按照用户要求配置的名称，可以为空2pswd接收状态报告验证的密码，可以为空3msgid提交短信时平台返回的msgid，参见1.24reportTime格式YYMMDDhhmm，其中YY=年

8、份的最后两位（00-99），MM=月份（01-12），DD=日（01-31），hh=小时（00