短信接口(验证码短信发送、会员通知、物流通知)是面向有一定技术开发能力的用户而单独研发的短信(sms)接口。本接口采用了通用的HTTP形式,可以支持各种操作系统和开发语言,只要电脑能 上网就可以使用发送短信,可以根据需要开发自己的一套短信平台。也可以简单的把短信接口嵌入到您自己的系统中,快速拥有无线应用,完善您的服务!同时提供 各种语言的例子代码。
提供专业短信送达服务,覆盖三网,高到达率,广泛用于订单通知,会议通知、物流信息,验证码等各类信息通知!
WEB平台功能
二次开发接口文档DOC
JAVA示例
ASP示例
PHP示例
C#示例
ASP.NET示例
VB.NET示例
短信接口主要适用对像
验证码短信、会员通知、会员服务、物流提醒、订单通知、订票信息、重大事件通知
一、工作方式
双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。
另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名和密码的方式。
二、字符编码
服务器接收数据默认是GBK编码,如提交的内容是UTF-8编码字符,需要添加参数encode=utf8。接入时应注意GBK编码只可以GET。请求响应返回内容编码与请求一致。
三、响应格式
所为响应即每次向服务器提交请求后返回值,响应值格式为纯文本状态码
如发送成功后返回 100
四、短信发送
GET/POST操作格式:http://api.web.sms137.com/?ac=send&uid=用户账号&pwd=MD5位32密码&mobile=号码&content=内容
接口参数说明:
参数名 |
参数字段 |
参数说明 |
uid |
用户账号 |
8位的接口帐号, 如:70356568 |
pwd |
用户密码 |
帐号登录密码小写32位MD5加密 |
mobile |
接收号码 |
同时发送给多个号码时,号码之间用英文半角逗号分隔(,)如:13972827282,13072827282,02185418874 GET 方式每次最多可以提交50条号码 POST 方式每次最多可以提交2000条号码[建议用POST方式提交] |
content |
短信内容 |
发送内容需要进行URL字符标准化转码。 ASP:server.URLEncode("短信内容") PHP:urlencode("短信内容") JAVA:java.net.URLEncoder.encode("短信内容") |
time |
定时时间 |
可选项,及时发送时参数无 格式:YYYY-MM-DD HH:MM 如:"2010-05-27 12:01" (年-月-日 时:分),发送时间以北京时间为准 |
encode |
字符编码 |
可选项,默认接收数据是GBK编码,只能GET,如提交的是UTF-8编码字符,需要添加参数 encode=utf8 |
例:15012345678
发送内容:企信通发送测试
发成功时响应状态码值: 100
返回发送的状态码
状态码说明
100 发送成功
101 验证失败
102 短信不足
103 操作失败
104 非法字符
105 内容过多
106 号码过多
107 频率过快
108 号码内容空
109 账号冻结
110 禁止频繁单条发送
111 系统暂定发送
112 号码错误
113 定时时间格式不对
114 账号被锁,10分钟后登录
115 连接失败
116 禁止接口发送
120 系统升级
五、接收回复短信
GET操作的格式:http://api.web.sms137.com/?ac=gr&uid=用户账号&pwd=MD5位32密码
注:提取的回复短信不能在重复提取,可以通过time参数重复提取某个时间的所有回复短信,需要间隔10分钟提取一次,不能频繁提取。
接口参数说明:
参数 |
参数字段名 |
说明 |
uid |
用户账号 |
8位的接口帐号, 如:70356568 |
pwd |
用户密码 |
小写32位MD5加密 |
例:http://api.web.sms137.com/?ac=gr&uid=70356568&pwd=fa246d0262c3925617b0c72bb20eeb1d
响应结果为纯文本,每次可接收多条回复信息:
状态码{&}回复号码||回复内容||回复时间||回复网关号{&}回复号码||回复内容||回复时间||回复网关号…….
例响应结果值:
100{&}13912341234||企信通测试回复||2008-05-27 12:10:11||1068112227282{&}15912343333||企信通测试回复2||2008-05-27 13:11:11||106811222728200
返回发送的状态码
无回复内容时返回空
状态码说明
100 接收成功
101 验证失败
六、取剩余短信条数
GET操作格式:http://api.web.sms137.com/?ac=gc&uid=用户账号&pwd=MD5位32密码
接口参数说明:
参数 |
参数字段名 |
说明 |
uid |
用户账号 |
8位的接口帐号, 如:70356568 |
pwd |
用户密码 |
小写32位MD5加密 |
例:http://api.web.sms137.com/?ac=gc&uid=70356568&pwd=fa246d0262c3925617b0c72bb20eeb1d
响应结果为纯文本:
状态码||剩余可发短信
例响应结果值:
100||22348
状态码说明
100 请求成功
101 验证失败
七、修改接口密码
GET操作格式:http://api.web.sms137.com/?ac=gp&uid=用户账号&pwd=MD5位32密码&npwd=MD5位32密码
接口参数说明:
参数 |
参数字段名 |
说明 |
uid |
用户账号 |
8位的接口帐号, 如:70356568 |
pwd |
原用户密码 |
小写32位MD5加密 |
npwd |
新用户密码 |
小写32位MD5加密 |
例:http://api.web.sms137.com/?ac=gp&uid=70356568&pwd=fa246d0262c3925617b0c72bb20eeb1d&npwd=e10adc3949ba59abbe56e057f20f883e
响应结果为纯文本:
状态码||总发短信条数
例响应结果值:
100||22348
状态码说明
100 修改成功
101 验证失败
107 频率过快
108 新密不为空
109 帐号已已冻结
114 帐号被锁
115 操作失败
116 禁止接口发送
117 绑定IP不正确