参数固定ip

HTTP接口文档接口域名:api.
sms.
cn一、工作方式11.
1密码验证方式1二、字符编码2三、响应格式2四、短信发送(单条,多条发送)2五、接收状态报告45.
1主动获取状态4六、接收上行短信(回复)46.
1主动接收上行短信(回复)46.
2推送接收上行短信(回复)5七、取剩余短信条数5八、取已发送总条数6九、接口安全(绑定IP)6十、取发送记录7一、工作方式双方通过HTTP方式交互数据,第三方可以简单的"name=value"方式发送提交内容或响应请求内容.
即通过HTTP的GET/POST方式交换.
另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名、密码和IP绑定的方式.
1.
1密码验证方式接口密码使用"登录密码"与"用户名"拼接字符串后能过md5加密进行验证如登录密码是:123123如用户名是:test接口密码(pwd)=md5(登录密码+用户名)pwd=md5(123123test)pwd=b9887c5ebb23ebb294acab183ecf0769二、字符编码服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8.
请求响应返回内容是GBK编码.
三、响应格式所为响应即每次向服务器提交请求后返回值响应值格式为纯文本四、短信发送(单条,多条发送)GET/POST操作格式:http://api.
sms.
cn/mt/uid=用户账号&pwd=MD532位密码&mobile=号码&mobileids=消息编号&content=内容接口参数说明:参数名参数字段参数说明uid用户账号登录名pwd用户密码32位MD5加密md5(密码+uid)如登录密码是:123123,uid是:test;pwd=md5(123123test)pwd=b9887c5ebb23ebb294acab183ecf0769mid子扩展号可选项,根据用户账号是否支持扩展encode字符编码可选项,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8mobile接收号码同时发送给多个号码时,号码之间用英文半角逗号分隔(,);小灵通需加区号如:13972827282,13072827282,02185418874GET方式每次最多可以提交50条号码POST方式每次最多可以提交2000条号码[建议用POST方式提交]mobileids消息编号可选项该参数用于发送短信收取状态报告用,格式为消息编号+逗号;与接收号码一一对应,可以重复出现多次.
消息编号:全部由数字组成接收状态报告的时候用到,该消息编号的格式为目标号码+当前时间戳整数,精确到毫秒,确保唯一性.
供收取状态报告用如:1590049111112869461937;content短信内容发送内容需要进行URL字符标准化转码.
{URL字符编码说明:返回字符串,此字符串中除了-_.
之外的所有非字母数字字符都将被替换成百分号(%)后跟两位十六进制数,空格则编码为加号(+)}ASP:server.
URLEncode("短信内容")PHP:urlencode("短信内容")JAVA:java.
net.
URLEncoder.
encode("短信内容")例:接收号:13900008888,1390000test,13100006666发送内容:发送测试http://api.
sms.
cn/mt/uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769&mobile=13900008888,1390000test,13100006666&mobileids=1390000888812869461937,1390000test12869461937,1310000666612869461937&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账号冻结110禁止频繁单条发送112号码错误113定时时间格式不对114账号被锁,10分钟后登录116禁止接口发送117绑定IP不正确120系统升级五、接收状态报告5.
1主动获取状态GET/POST操作格式:http://api.
sms.
cn/st/uid=用户账号&pwd=MD532位密码接口参数说明:参数名参数字段参数说明uid用户账号pwd用户密码32位MD5加密md5(登录密码+用户账号)例:http://api.
sms.
cn/st/uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769响应返回值:18817660001,100,188176600011234556789,2011-03-1111:22:1118817660002,100,188176600021234556311,2011-03-1111:28:22说明:手机号,状态,发送唯一编号,状态返回时间+换行每条状态记录以换行分隔,一行一条状态记录六、接收上行短信(回复)6.
1主动接收上行短信(回复)操作的格式:http://api.
sms.
cn/rx/uid=用户账号&pwd=MD532位密码注:提取的回复短信不能在重复提取接口参数说明:参数参数字段名说明uid用户账号pwd用户密码小写32位MD5加密例:http://api.
sms.
cn/rx/uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769响应结果为纯文本,每次可接收多条回复信息:状态码{&}回复号码||回复内容||回复时间||回复网关号{&}回复号码||回复内容||回复时间||回复网关号…….
例响应结果值:100{&}13912341234||短信测试回复||2008-05-2712:10:11||1068112227282{&}15912343333||短信测试回复2||2009-05-2713:11:11||106811222728200返回发送的状态码无回复内容时返回空注:对回复的内容中有||会自动转成全角||字符串6.
2推送接收上行短信(回复)使用说明:由服务器平台发送上行回复短信到您的接口程序上,使用Http协议GET和POST方式发送,您需要提交一个http接口地址来接收如下格式参数值操作的格式:http://您服务器接口地址cmd=res&uid=用户账号&mobileids=消息编号&mobile=接收号码&status=消息状态接口参数说明:参数参数字段名说明cmd操作命令返回值:resuid用户账号返回值:发送短信用户名time回复时间返回值:YYYY-MM-DDHH:II:SSmobile接收号码返回值:接收的号码content消息内容返回值:GBK字符串七、取剩余短信条数操作格式:http://api.
sms.
cn/mm/uid=用户账号&pwd=MD5位32密码接口参数说明:参数参数字段名说明uid用户账号pwd用户密码32位MD5加密例:http://api.
sms.
cn/mm/uid=test&pwd=fa246d0262c3925617b0c72bb20eeb1d响应结果为纯文本:sms&stat=状态码&remain=剩余可发短信例响应结果值:sms&stat=100&remain=100八、取已发送总条数操作格式:http://api.
sms.
cn/mm/uid=用户账号&pwd=MD5位32密码&cmd=send接口参数说明:参数参数字段名说明uid用户账号pwd用户密码32位MD5加密cmdsend取已发送条数例:http://api.
sms.
cn/mm/uid=test&pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send响应结果为纯文本:sms&stat=状态码&remain=已发短信例响应结果值:sms&stat=100&remain=100九、接口安全(绑定IP)为了接口更加的安全,请登录WEB平台在"系统设置"中绑定你服务器的IP地址,可绑定10个固定IP,绑定IP后只有通过你的服务器来发送短信,防止他人使用十、取发送记录操作的格式:http://api.
sms.
cn/rd/uid=用户账号&pwd=MD532位密码&page=1接口参数说明:每次最多取50条记录,可以根据页数依次取完参数参数字段名说明uid用户账号pwd用户密码小写32位MD5加密page页数可选项,取第多少页记录date日期可选项,取指定日期记录(2012-12-12)key查询号码可选项,取指定手机号记录encode字符编码可选项,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8例:http://api.
sms.
cn/rd/uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769响应结果为纯文本,每记录用"|#|"隔开,每个字段之间用"||";返回如下格式:总记录数||当前记录数||总页数|#|发送时间||号码||内容||状态|#|发送时间||号码||内容||状态|#|…….
无回复内容时返回空