中国短信网http接口文档

1、中国短信网中国短信网HTTPHTTP短信接口文档短信接口文档v2.2v2.2最新修改时间最新修改时间:2009-04-08:2009-04-08接口域名：接口域名：一一、工工作作方方式式.1二二、字字符符编编码码.2三三、响响应应格格式式.2四四、短短信信发发送送.2五五、接接收收回回复复短短信信.3六六、取取剩剩余余短短信信条条数数 .4七七、取取已已发发送送总总条条数数 .5八八、密密码码修修改改.5九九、接接口口安安全全（绑绑定定 I IP P）.6十十、状状态态码码说说明明 .6十十一一、程程序序示示例例下下载载 .7测测 试试 账账 号号用用户户名名: :9 99 99 99 9密密

2、 码码: :9 99 99 99 9一一、工工作作方方式式双方通过HTTP方式交互数据，第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。另外双方需要保证数据传输的完整性和安全性，每次发送请求都有响应(响应返回格式为纯文本)，安全验证目前采用用户名和密码的方式。二二、字字符符编编码码服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8。请求响应返回内容是GBK编码。三三、响响应应格格式式所为响应即每次向服务器提交请求后返回值响应值格式为纯文本状态

3、码如发送成功后返回100四四、短短信信发发送送GET/POST操作格式：/?uid=用户账号&pwd=MD5位32密码&mobile=号码&content=内容接口参数说明:参数名参数字段参数说明uid用户账号pwd用户密码小写32位MD5加密time定时时间可选项，及时发送时参数无 格式:YYYY-MM-DD HH:MM如：2010-05-27 12:01 (年-月-日 时:分),发送时间以北京时间为准mid子扩展号可选项，根据用户账号是否支持扩展encode字符编码可选项，默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8m

4、obile接收号码同时发送给多个号码时,号码之间用英文半角逗号分隔(,)如:,G GE ET T 方式每次最多可以提交50条号码P PO OS ST T方式每次最多可以提交2000条号码建议用POST方式提交content短信内容发送内容需要进行URL字符标准化转码。URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码为加号（+）ASP：server.URLEncode(短信内容)PHP：urlencode(短信内容)JAVA：.URLEncoder.encode(短信内容)例例: :接接 收收 1 10 00 00

5、 00 06 66 66 66 6, ,0 02 21 18 88 88 82 22 22 28 8发发送送内内容容：中中国国短短信信网网发发送送测测试试9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&mobile=&content=%D6%D0%B9%FA%B6%CC%D0%C5%CD%F8%B7%A2%CB%CD%B2%E2%CA%D4发成功时响应状态码值: 100返回发送的状态码状状态态码码说说明明100 发送成功101 验证失败102 短信不足103 操作失败104 非法字符105 内容过多106 号码过多107 频率过快10

6、8 号码内容空109 账号冻结110 禁止频繁单条发送111 系统暂定发送112 号码错误113 定时时间格式不对114 账号被锁，10分钟后登录115 连接失败116 禁止接口发送117 绑定IP不正确120 系统升级五五、接接收收回回复复短短信信操作的格式：rx/?uid=用户账号&pwd=MD5位32密码注：提取的回复短信不能在重复提取，可以通过time参数重复提取某个时间的所有回复短信，需要间隔10分钟提取一次，不能频繁提取。接口参数说明:参数参数字段名说明uid用户账号pwd用户密码小写32位MD5加密time取时间段可选项，可以取某个小时回复的内容，内容可以重复取，格式：(

7、YYYY-MM-DD_HH 如：2008-05-27_14)例例: :rx/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d 响应结果为纯文本,每次可接收多条回复信息：状态码&回复号码|回复内容|回复时间|回复网关号&回复号码|回复内容|回复时间|回复网关号.例例响响应应结结果果值值: :无回复内容时返回空状状态态码码说说明明100接收成功101验证失败六六、取取剩剩余余短短信信条条数数操作格式：mm/?uid=用户账号&pwd=MD5位32密码接口参数说明:参数参数字段名说明uid用户账号pwd用户密码32位MD5加

8、密例例: :mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d 响应结果为纯文本：状态码|剩余可发短信 例例响响应应结结果果值值: :100|22348七七、取取已已发发送送总总条条数数操作格式：httmm/?uid=用户账号&pwd=MD5位32密码&cmd=send接口参数说明:参数参数字段名说明uid用户账号pwd用户密码32位MD5加密cmdsend取已发送条数例例: :mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send 响应结果为纯

9、文本：状态码|总发短信条数 例例响响应应结结果果值值: :100|22348状状态态码码说说明明100请求成功101验证失败八八、密密码码修修改改操作格式：pw/?uid=用户账号&pwd=MD532位密码&newpwd=新密码接口参数说明:参数参数字段名说明uid用户账号pwd用户密码32位MD5加密newpwd新密码新的密码，不需要MD5例例: :将将密密码码改改成成：1 12 23 31 12 23 3mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&newpwd=123123响应结果为纯文本：状态码例例响响应应结结果果值值: :100状状态态码码说说明明100修改成功101验证失败103填写新密码九九、接接口口安安全全（绑绑定定I IP P）为了接口安全，请登录平台sms.c123 在“系统设置”中绑定你服务器的IP地址，可绑定3个固定IP,绑定IP后只有通过你的服务器来发送短信，防止他人使用十十、状状态态码码说说明明返回发送的状态码状状态态码码说说明明100 发送成功101 验证失败102 短信不足103 操作失败104 非法字符