出错啦Oops，云飘走了！404 - 页面不存在 - Not foundHTTP电脑发送短信接口调用示例
一、工作方式
双方通过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=内容
接口参数说明:
32位MD5加密md5(密码+uid)
如登录密码是：123123 ，uid是：
pwd=md5(123123test)
pwd=b9887c5ebb23ebb294acab183ecf0769
可选项，及时发送时参数无 格式:YYYY-MM-DD HH:MM　如：" 12:01" (年-月-日 时:分),发送时间以北京时间为准
可选项，根据用户账号是否支持扩展
可选项，默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8
同时发送给多个号码时,号码之间用英文半角逗号分隔(,);小灵通需加区号
GET　 方式每次最多可以提交50条号码
POST　方式每次最多可以提交2000条号码[建议用POST方式提交]
该参数用于发送短信收取状态报告用，格式为消息编号+逗号；与接收号码一一对应，可以重复出现多次。
消息编号:全部由数字组成接收状态报告的时候用到，该消息编号的格式为目标号码+当前时间戳整数，精确到毫秒，确保唯一性。供收取状态报告用 如: ;
发送内容需要进行URL字符标准化转码。
{URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码为加号（+）}
ASP：server.URLEncode("短信内容")
PHP：urlencode("短信内容")
JAVA：java.net.URLEncoder.encode("短信内容")
接 收 号：,,
发送内容：发送测试
发成功时响应状态码值:
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位密码
接口参数说明:
32位MD5加密 md5(登录密码+用户账号)
http://api.sms.cn/st/?uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769
响应返回值:
手机号,状态,发送唯一编号,状态返回时间+换行
每条状态记录以换行分隔，一行一条状态记录
5.2 推送接收状态报告
发送状态报告请求消息
使用说明：由服务器平台发送状态报告到您的接口程序上，使用Http协议GET和POST方式发送，您需要提交一个http接口地址来接收如下格式参数值
操作的格式：
http://您服务器接口地址?cmd=stat&uid=用户账号&mobileids=消息编号&mobile=接收号码&status=消息状态
接口参数说明:
参数字段名
返回值：stat
返回值：发送短信用户名
返回值：消息编号
返回值：接收的号码
100 //成功
130 //失败
131 //空号
132 //停机
133 //关机
134 //无状态
http://您服务器接口地址?cmd=stat&uid=test&mobileids=&mobile=&status=100
六、接收上行短信（回复）
6.1 主动接收上行短信（回复）
操作的格式：
http://api.sms.cn/rx/?uid=用户账号&pwd=MD5 32位密码
注：提取的回复短信不能在重复提取
接口参数说明:
参数字段名
小写32位MD5加密
响应结果为纯文本,每次可接收多条回复信息：
状态码{&}回复号码||回复内容||回复时间||回复网关号{&}回复号码||回复内容||回复时间||回复网关号…….
例响应结果值:
100{&}||短信测试回复|| 12:10:11||2{&}||短信测试回复2|| 13:11:11||200
返回发送的状态码
无回复内容时返回空
注：对回复的内容中有||会自动转成全角｜｜字符串
6.2 推送接收上行短信（回复）
使用说明：由服务器平台发送上行回复短信到您的接口程序上，使用Http协议GET和POST方式发送，您需要提交一个http接口地址来接收如下格式参数值
操作的格式：
http://您服务器接口地址?cmd=res&uid=用户账号&mobileids=消息编号&mobile=接收号码&status=消息状态
接口参数说明:
参数字段名
返回值：res
返回值：发送短信用户名
返回值：YYYY-MM-DD HH:II:SS
返回值：接收的号码
返回值：GBK字符串
七、接口安全（绑定IP）
为了接口安全，请登录WEB平台在“系统设置”中绑定你服务器的IP地址，可绑定3个固定IP,绑定IP后只有通过你的服务器来发送短信，防止他人使用
Copyright (C) , All Rights Reserved.
版权所有 闽ICP备号
processed in 0.035 (s). 12 q(s)API接口说明文档
1、API接口系统说明(5月26日更新了api接口地址，之前对接的需要更新后才可以使用)
注： 软件作者在注册帐号时申请为普通用户就能享受软件提成哦！(普通用户都是开发者) 开发者提成项目金额的 10%
API 接口地址：http://xapi.yzm7.com
接口统一编码：GB2312 [ 如需要使用UTF-8编码，请每个接口加入参数 Code=UTF8 ]
接口调用方式：HTTP GET方式
GET调用方法：http://xapi.yzm7.com/Method?参数1=值&参数2=值（具体方法名及参数请参考接口方法）
1.1、注意事项
1. 所有接口访问地址和参数，都需区分大小写，一定需注意。
2. 所有接口如有错误，前端都会有一个False:后面则是错误信息,下面接口说明不在说明错误信息，其他为正确。
3. 当没有按照接口说明的参数去调用，参数没有携带完整，则系统会返回 False:信息不完整。
4. 登录后，如果在10分钟没有再次用token访问其他接口信息，则登录token会被系统自动回收，如果再用以前的token去访问，则会返回：Session过期，这样需重新再次登陆，使用新的token。
5. 获取号码在20分钟内没有被用户释放，系统会强制进行释放信息。
2、用户登录
GET - GET方式调用实例：http://xapi.yzm7.com/Login?uName=用户名&pWord=密码&Developer=开发者参数
开发者参数请登录平台查看(普通用户)
2.1、请求参数
参数名必传缺省值描述
uNameY用户名
pWordY密码
DeveloperN开发者参数
2.2、返回值
登录token&账户余额&最大登录客户端个数&最多获取号码数&单个客户端最多获取号码数&折扣
注意：只要密码不变，登录方法只需要调用一次获取到token即可，程序运行中请不要重复调用
登录后，如果在10分钟没有再次用token访问其他接口信息，则登录token会被系统自动回收，如果再用以前的token去访问，则会返回：Session过期，这样需重新再次登陆，使用新的token。
3、获取项目
GET - GET方式调用实例：http://xapi.yzm7.com/GetItems?token=token&tp=ut
3.1、请求参数
参数名必传缺省值描述
tokenY登录token
tpY类型 [固定值 ut]
3.2、返回值
项目ID&项目名称&项目价格&项目类型\n项目ID&项目名称&项目价格&项目类型\n...
其中项目类型解释如下：
1. 表示此项目用于接收验证码
2. 表示此项目用户发送短信
3. 表示此项目即可接收验证码，也可以发送短信
4. 表示可以接受多个验证码
4、获取区域
GET - http://xapi.yzm7.com/GetArea?
无请求参数[注意: ? 号必须加上]
4.1、返回值
正确返回例子： 重庆\n上海\n北京\n
5、获取号码（注意：获取消息的项目ID为itemId，注意大小写）
GET - http://xapi.yzm7.com/getPhone?ItemId=项目ID&token=登陆token
5.1、请求参数
参数名必传缺省值描述
tokenY登录token
ItemIdY项目代码（获取消息的项目代码为itemId，注意大小写）
CountN1获取数量 [不填默认1个]
AreaN区域 [不填则 随机]td>
PhoneTypeN运营商 [不填为 0] 0 [随机] 1 [移动] 2 [联通] 3 [电信]
PhoneN指定号码
5.2、返回值
正确返回：;;;
注意：如果Count数量为20，获取后，确只返回了10个号码，则证明系统已经没有
6、获取消息（注意：获取消息的项目ID为itemId，此处的i为小写）
GET - http://xapi.yzm7.com/getMessage?token=登陆token&itemId=项目ID&phone=手机号码
6.1、请求参数
参数名必传缺省值描述
tokenY登录token
phoneY手机号码
itemId（注意：此处的i为小写）Y项目ID
6.2、返回值
1.使用该方法获得验证码后，系统自动释放该号码
2.此接口需要一直调用，建议该方法每5秒调用一次，然后将获取的内容进行拆分匹配
正确返回：【消息队列】消息队列介绍：
1. 消息队列信息最后末尾为[End]结束
2. 消息队列信息划分都已 & 符号分割
3. 消息队列第一分割字符为命令类型
消息队列命令种类
1. 用户状态信息:USER&余额&最大登录数&最大获取号码数&客户端最大获取号码数&折扣
2. 短信内容:MSG&项目ID&号码&短信内容
3. 发送状态:STATE&项目ID&号码&状态信息
4. 号码释放通知:RES&项目ID&号码
7、释放手机号码
GET - http://xapi.yzm7.com/releasePhone?token=登陆token&phoneList=phone-itemId;phone-itemId;
号码列表格式: phone-itemId;phone-itemId; 其中phone为号码，itemId为项目ID, 请注意后面的分号需要加上
7.1、请求参数
参数名必传缺省值描述
tokenY登录token
phoneListY号码列表
7.2、返回值
正确返回：【消息队列】，请到消息队列查看消息队列格式, 此处可能会有验证码短信内容
8、发送短信
GET - http://xapi.yzm7.com/sendMessage?token=登陆token&Phone=手机号&ItemId=项目ID&Msg=短信内容
8.1、请求参数
参数名必传缺省值描述
tokenY登录token
ItemIdY项目代码
phoneY号码
MsgY短信内容
8.2、返回值
正确返回：Ok
注意：调用“发送短信”后，通过 “获取消息”检查短信发送状态
9、添加号码到黑名单
GET-http://xapi.yzm7.com/addBlack?token=登陆token&phoneList=itemId-phone,phone,itemId-phone,
号码列表格式: itemId-phone,phone,itemId-phone, 其中phone为号码，itemId为项目ID, 请注意后面的分号需要加上
9.1、请求参数
参数名必传缺省值描述
tokenY登录token
phoneListY号码列表
9.2、返回值
正确返回：【消息队列】，请到消息队列查看消息队列格式, 此处可能会有验证码短信内容
注意：当加入黑名单的号码为已经获取了的号码，则系统会自动释放此号码
GET - http://xapi.yzm7.com/Exit?token=登陆token[注：关闭软件前务必调用]
10.1、请求参数
参数名必传缺省值描述
tokenY登录token
10.2、返回值
正确返回：Ok全国免费服务热线
9:00-21:00 ×365天
400-699-1455
在线企业QQ：　
SMS短信通API下行接口参数
重要提示:用接口发送验证码的程序员注意，近期短信验证码轰炸软件泛滥，请在发送验证码的时候，加上一个图形校验码验证，防止机器人读取狂发验证码！！！不明事宜请联系客服咨询。发送手机验证码请做好以下几点防范：
发送验证码1分钟只能点击发送1次；
相同IP手机号码1天最多提交20次；
验证码短信单个手机号码30分钟最多提交10次；
在提交页面加入图形校验码，防止机器人恶意发送；
在发送验证码接口程序中，判断图形校验码输入是否正确；
新用户用接口测试验证码时，请勿输入：测试等无关内容信息，请直接输入：验证码:xxxxxx，发送。
接口发送触发短信时，您可以把短信内容提供给客服绑定短信模板，绑定后24小时即时发送。未绑定模板的短信21点以后提交，隔天才能收到。
GBK编码发送接口地址：
http://gbk.api.smschinese.cn/?Uid=本站用户名&Key=接口安全秘钥&smsMob=手机号码&smsText=验证码:8888
UTF-8编码发送接口地址：
http://utf8.api.smschinese.cn/?Uid=本站用户名&Key=接口安全秘钥&smsMob=手机号码&smsText=验证码:8888
获取短信数量接口地址(UTF8)：
http://www.smschinese.cn/web_api/SMS/?Action=SMS_Num&Uid=本站用户名&Key=接口安全秘钥
获取短信数量接口地址(GBK)：
http://www.smschinese.cn/web_api/SMS/GBK/?Action=SMS_Num&Uid=本站用户名&Key=接口安全秘钥
提示:HTTP调用URL接口时, 参数值必须URL编码后再调用
Gbk编码Url
http://gbk.api.smschinese.cn/
Utf-8编码Url
http://utf8.api.smschinese.cn/
本站用户名（如您无本站用户名请先注册）
注册时填写的接口秘钥（可到用户平台修改接口秘钥）
如需要加密参数，请把Key变量名改成KeyMD5，
KeyMD5=接口秘钥32位MD5加密，大写。
目的手机号码（多个手机号请用半角逗号隔开）
短信内容，最多支持400个字，普通短信70个字/条，长短信64个字/条计费
多个手机号请用半角,隔开
如：,, 一次最多对100个手机发送
短信内容支持长短信，最多400字，普通短信70个字/条含签名，长短信64字/条计费
短信发送后返回值
没有该用户账户
接口密钥不正确
不是账户登陆密码
MD5接口密钥加密不正确
短信数量不足
该用户被禁用
短信内容出现非法字符
手机号格式不正确
手机号码为空
短信内容为空
短信签名格式不正确
接口签名格式为：【签名内容】
短信发送数量
注：调用API接口，请登录平台，申请106网关发送，即发即到！
　　发送测试短信请勿输入：短信测试等词语，请直接提交您要发送的短信内容；
　　接口发送短信时请在内容后加签名：【XX公司或XX网名称】，否者会被屏蔽。
　　短信签名可在用户平台平台上设置，也可以在短信内容后，直接加入。
1. ASP 调用例子
'输入url目标网页地址，返回值getHTTPPage是目标网页的html代码
getHTTPPage(url)
Http=server.createobject(&MSXML2.XMLHTTP&)
&GET&,url,false
Http.send()
if Http.readystate&&4 then
getHTTPPage=bytesToBSTR(Http.responseBody,&GB2312&)
http=nothing
if err.number&&0 then err.Clear
Function BytesToBstr(body,Cset)
dim objstream
set objstream =
Server.CreateObject(&adodb.stream&)
objstream.Type = 1
objstream.Mode
objstream.Open
objstream.Write body
objstream.Position =
objstream.Type = 2
objstream.Charset = Cset
BytesToBstr =
objstream.ReadText
objstream.Close
set objstream = nothing
'自已组合一下提交的URL加入自己的账号和密码
sms_url=&http://sms.webchinese.cn/web_api/?Uid=账号&Key=接口密钥&smsMob=手机号码&smsText=验证码：8888&
response.write
getHTTPPage(sms_url)
//需要用到的命名空间
using System.N
using System.IO;
//调用时只需要把拼成的URL传给该函数即可。判断返回值即可
public string
GetHtmlFromUrl(string url)
string strRet =
if(url==null || url.Trim().ToString()==&&)
string targeturl =
url.Trim().ToString();
HttpWebRequest hr =
(HttpWebRequest)WebRequest.Create(targeturl);
hr.UserAgent = &Mozilla/4.0
( MSIE 6.0; Windows NT 5.1)&;
hr.Method = &GET&;
hr.Timeout =
30 * 60 * 1000;
WebResponse hs = hr.GetResponse();
Stream sr =
hs.GetResponseStream();
StreamReader ser = new StreamReader(sr,
Encoding.Default);
strRet = ser.ReadToEnd();
catch (Exception
return strR
3.JAVA调用
import java.io.UnsupportedEncodingE
import org.apache.commons.httpclient.H
import org.apache.commons.httpclient.HttpC
import org.apache.commons.httpclient.NameValueP
import org.apache.commons.httpclient.methods.PostM
public class SendMsg_webchinese {
public static void main(String[] args)throws Exception
HttpClient client = new HttpClient();
PostMethod post = new PostMethod(&http://gbk.api.smschinese.cn&);
post.addRequestHeader(&Content-Type&,&application/x-www-form-charset=gbk&);//在头文件中设置转码
NameValuePair[] data ={ new NameValuePair(&Uid&, &本站用户名&),new NameValuePair(&Key&, &接口安全秘钥&),new NameValuePair(&smsMob&,&手机号码&),new NameValuePair(&smsText&,&验证码：8888&)};
post.setRequestBody(data);
client.executeMethod(post);
Header[] headers = post.getResponseHeaders();
int statusCode = post.getStatusCode();
System.out.println(&statusCode:&+statusCode);
for(Header h : headers)
System.out.println(h.toString());
String result = new String(post.getResponseBodyAsString().getBytes(&gbk&));
System.out.println(result); //打印返回消息状态
post.releaseConnection();
演示程序下载
说明：如果返回值是200，应该是整段程序代码没有执行完整，只获取到client.executeMethod(post)HTTP状态码的消息；接口是提交成功，没有执行下半部的返回消息代码。client.executeMethod(post);HTTP状态码参考：
$url='http://sms.webchinese.cn/web_api/?Uid=账号&Key=接口密钥&smsMob=手机号码&smsText=验证码：8888';
echo Get($url);
if(function_exists('file_get_contents'))
$file_contents
= file_get_contents($url);
$ch = curl_init();
$timeout =
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch,
CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT,
$timeout);
$file_contents =
curl_exec($ch);
curl_close($ch);
return $file_
'调用发送短信,NoList接收号码.多个之间用,分开,Memo内容70字
Public Function SendSMS(ByVal NoList As String, ByVal Memo As String) As String
Dim Url As String = &http://sms.webchinese.cn/web_api/?Uid=账号&Key=接口密钥&smsMob=手机号码&smsText=验证码：8888&
Dim webClient As New Net.WebClient()
'Dim responseData As Byte() =
Dim srcString As String = webClient.DownloadString(Url)
Return srcString
Return &-444&
End Function
Public Function getHtmlStr(strUrl As String) '获取远程接口函数
On Error Resume Next
Dim XmlHttp As Object, stime, ntime
Set XmlHttp = CreateObject(&Microsoft.XMLHTTP&)
XmlHttp.open &GET&, strUrl, True
XmlHttp.send
stime = Now '获取当前时间
While XmlHttp.ReadyState && 4
ntime = Now '获取循环时间
If DateDiff(&s&, stime, ntime) & 3 Then getHtmlStr = &&: Exit Function
getHtmlStr = StrConv(XmlHttp.responseBody, vbUnicode)
Set XmlHttp = Nothing
End Function
代码使用：在窗体代码相应位置写如下代码
dim a as string
a=getHtmlStr(&http://sms.webchinese.cn/web_api/?Uid=账号&Key=接口密钥&smsMob=手机号码&smsText=验证码：8888&) '获取接口返回值