HTTP接口文档

1、HTT麟口文档接口域名：一、工作方式 错误!未定义书签1.1密码验证方式 错误!未定义书签二、字符编码 错误!未定义书签三、响应格式 错误!未定义书签四、短信发送（单条，多条发送） 错误!未定义书签五、接收X态报告错误!未定义书签5.1 主动获取状态 错误!未定义书签六、接收上行短信（回复） 错误!未定义书签5.2 主动接收上行短彳t （回复） 错误!未定义书签5.3 推送接收上行短彳t （回复） 错误!未定义书签七、取剩余短信条数错误!未定义书签八、取已发送总条数错误!未定义书签九、接口安全（绑定 IP） 错误!未定义书签十、取发送记录错误!未定义书签一、工作方式双方通过HTTP式交互数据，

2、第三方可以简单的" name=value ”方式发送提交内容或 响应请求内容。即通过HTTFPGET/POST式交换。另外双方需要保证数据传输的完整性和安全性，每次发送请求都有响应（响应返回格式为纯文本），安全验证目前采用用户名、密码和 IP绑定的方式。1.1 密码验证方式接口密码使用“登录密码”与“用户名”拼接字符串后能过md珈密进行验证如登录密码是：123123如用户名是：test接口密码（pwd） =md5（登录密码+用户名）pwd=md5（123123test）pwd由9887c5ebb23ebb294acab183ecf0769二、字符编码服务器接收数据可以是 GB娥UTF

3、-8编码字符，默认接收数据是 GB编码，如提交的是UTF-8编码字符，需要添加参数encode=utf8 。请求响应返回内容是 GB编码。三、响应格式所为响应即每次向服务器提交请求后返回值响应值格式为纯文本四、短信发送（单条，多条发送）GET/POST作格式：/?uid=用户账号 &pwd=MD532 位密码 &mobile=号码 &mobileids=消息编号 &content=内容接口参数说明：参数名参数字段参数说明uid用户账号登录名pwd用户密码32位MD5J口密 md5(密码 +uid)如登录密码是：123123 , uid是：test;pwd=md5

4、(123123test)pwd=b9887c5ebb23ebb294acab183ecf0769mid子扩展号可选项，根据用户账号是否支持扩展encode字符编码可选项，默认接收数据是GB编码，如提交的是UTF-8编码字符，需要添力口参数 encode=utf8mobile接收号码同时发送给多个号码时，号码之间用英文半角逗号分隔（，）；小灵通需加区号如:,074GET 方式每次最多可以提交 50条号码POST方式每次最多可以提交 2000条号码建议用POSTT式提交mobileids消息编号可选项该参数用于发送短信收取状态报告用，格式为消息编号+逗号；与接收号码一一对应，可以重复出现多次。消息

5、编号：全部由数字组成接收状态报告的时候用到， 该消息编号的格式 为目标号码+当前时间戳整数，精确到毫秒，确保唯一性。供收取状态报 告用如：9461937;content短信内容发送内容需要进行UR序符标准化转码。URL字符编码说明：返回字符串，此字符串中除了 -_.之外的所有非字母 数字字符都将被替换成百分号 （）后跟两位十六进制数，空格则编码 为加号（+ ） ASP server.URLEncode（"短信内容"）PHP urlencode（"短信内容"）JAVA "短信内容"）例：接收号:,1390000test,发送内容：发送测

6、试/?uid= test &pwd= b9887c5ebb23ebb294acab183ecf0769&mobile=,1390000test,&mobileids=888,1390000test,666&content=%B7%A2%CB%CD%B2%E2%CA%D4发成功时响应状态码值：sms&stat=100&message= 发送成功stat 状态码message 状态说明返回发送的状态码状态码 说明100发送成功101验证失败102短信不足103操作失败104非法字符105内容过多106号码过多107频率过快108号码内容空109账号冻

7、结110禁止频繁单条发送112号码错误113定时时间格式不对114账号被锁，10分钟后登录116禁止接口发送117绑定IP不正确120系统升级五、接收状态报告5.1主动获取状态GET/POST作格式：/?uid=用户账号&pwd=MD532 位密码接口参数说明参数名参数字段参数说明uid用户账号pwd用户密码32位MD口密md5（登录密码+用户账号）例：/?uid= test &pwd= b9887c5ebb23ebb294acab183ecf0769 响应返回值：,100,556789,2011-03-1111:22:11,100,556311,2011-03-1111:28

8、:22说明：手机号，状态，发送唯一编号，状态返回时间+换行每条状态记录以换行分隔，一行一条状态记录六、接收上行短信（回复）6.1 主动接收上行短信（回复）操作的格式：/?uid=用户账号&pwd=MD532 位密码注：提取的回复短信不能在重复提取接口参数说明参数参数字段名说明uid用户账号pwd用户密码小写32位MD咖密例：/?uid= test &pwd=b9887c5ebb23ebb294acab183ecf0769响应结果为纯文本，每次可接收多条回复信息：状态码&回复号码|回复内容|回复时间|回复网关号&回复号码|回复内容|回复时间| 回复网关号.例响应结

9、果值：100&| 短信测试回复 |2008-05-27 12:10:11|27282&|短信测试回复 2|2009-05-27 13:11:11|1068返回发送的状态码无回复内容时返回空注：对回复的内容中有|会自动转成全角| |字符串6.2 推送接收上行短信（回复）使用说明：由服务器平台发送上行回复短信到您的接口程序上，使用 Http协议GETf口 PO ST式发送，您需要提交一个http接口地址来接收如下格式参数值操作的格式: 接口参数说明：参数参数字段名说明cmd操作命令返回值：resuid用户账号返回值：发送短信用户名time回复时间返回彳直:YYYY-MM-DD HH

10、:II:SSmobile接收号码返回值：接收的号码content消息内容返回彳1: GB停符串七、取剩余短信条数操作格式：/?uid=用户账号&pwd=MD5 位32密码接口参数说明参数参数字段名说明uid用户账号pwd用户密码32位MD咖密例：/?uid= test &pwd=fa246d0262c3925617b0c72bb20eeb1d响应结果为纯文本：sms&stat=状态码&remain=剩余可发短信例响应结果值：sms&stat=100&remain=100八、取已发送总条数操作格式：/?uid=用户账号 &pwd=MD5 位

11、32 密码 &cmd=send接口参数说明参数参数字段名说明uid用户账号pwd用户密码32位MD咖密cmdsend取已发送条数例：/?uid= test &pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send响应结果为纯文本：sms&stat= 状态码 &remain=已发短信例响应结果值：sms&stat=100&remain=100九、接口安全(绑定IP)为了接口更加的安全，请登录WEy台在“系统设置”中绑定你服务器的IP地址，可绑定10个固定IP,绑定IP后只有通过你的服务器来发送短信，防止他人使用十、取发送记录操作的格式：/?uid=用户账号 &pwd=MD532 位密码 &page=1接口参数说明：每次最多取50条记录，可以根据页数依次取完参数参数字段名说明uid用户账号pwd用户密码小写32位MD咖密page页数可选项，取第多少页记录date日期可选项，取指定日期记录(2012-12-12 )key查询号码可选项，取指定手机号记录encode字符编码可选项，默认接收数据是GB编码，如提交的是UTF-8编码字