三网短信验证码示例代码

短信接口(HTTP协议)

向指定手机号码发送短信息,内容由客户自定义,HTTP短信接口为GB2312编码。
使用前需要先注册短信接口帐号并于客户经理取得联系,开启授权,充值测试费用
短信验证码30分钟相同手机号发送请勿超过5条,其余内容相同号码接收量控制在<=20

温馨提示! 尊敬的客户,为了你调用我司短信接口快速收到不被拦截,请在调用短信接口的发送短信的时候请发送正规的验证码内容,

如: 【速码云】尊敬的客户你好,你获取的验证码为:548976.

或者发送祝福短信。切勿发送违规,违法,辱骂等短信内容,谢谢!

 

发送短信

请求地址


短信接口支持编码 短信接口请求地址 短信接口请求方式
UTF-8 http://193.112.55.83:8868/sms.aspx GET,POST,SOAP
GB2312 http://193.112.55.83:8868/smsGBK.aspx GET,POST,SOAP


请求参数


名称 类型 描述 是否必须 更多限制 示例值
userid String 企业ID 必须 联系短信接口方提供 12
account String 发送用户帐号 必须 无需加密 UserName
password String 发送用户密码 必须 无需加密 PassWord
mobile String 被叫号码 必须 发送目的号码.多个号码之间用半角逗号隔开 13000000000,13100000000
content String 发送内容 必须 根据请求地址来确定编码格式 你好你的验证码是:123456
sendTime datetime() 短信接口发送时间 可不填 为空即时发送,格式:yyyy/mm/dd hh:mm:ss 2016/06/20 11:50:41
action String 发送任务命令 必须 设置为固定的:send action=send
extno String 扩展子号 可不填 请先询问配置的通道是否支持扩展子号,如果不支持,请填空。 只好只能5位数:12345


响应参数


名称 类型 示例值 描述
HTTP短信接口返回值 String <?xml version="1.0" encoding="utf-8" ?> <returnsms> <returnstatus>status</returnstatus> <message>message</message> <remainpoint> remainpoint</remainpoint> <taskID>taskID</taskID> <successCounts>successCounts</successCounts> </returnsms> 状态码/返回信息/本次任务的序列ID/成功短信数


请求实例


温馨提示! 尊敬的客户,为了你调用我司的短信接口快速收到不被拦截,请在调用短信接口的发送短信验证码的时候请发送正规的短信验证码内容,
如: 尊敬的客户你好,你获取的验证码为:548976 请输入及时验证,谢谢!或者发送祝福短信



状态码解释


状态码 状态描述
ok 短信接口提交成功
对不起,您当前要发送的量大于您当前余额 当支付方式为预付费是,检查到账户余额不足
用户名或密码不能为空 提交的用户名或密码为空
发送内容包含sql注入字符 包含sql注入字符
用户名或密码错误 表示用户名或密码错误
短信接口号码不能为空 提交的被叫号码为空
短信接口内容不能为空 发送内容为空
包含非法字符: 表示检查到不允许发送短信的非法字符
其他错误 其他数据库操作方面的错误
 

短信接口余额查询

短信接口请求地址


支持编码 请求地址 请求方式
UTF-8 http://193.112.55.83:8868/sms.aspx GET,POST,SOAP
GB2312 http://193.112.55.83:8868/smsGBK.aspx GET,POST,SOAP


请求参数


名称 类型 描述 是否必须 更多限制 示例值
userid String(20) 企业ID 必须 企业ID 12
account String(20) 用户帐号 必须 用户帐号,由系统管理员 UserName
password String(20) 帐号密码 必须 用户账号对应的密码 PassWord
action String(20) 任务命令 必须 设置为固定的:overage action=overage


响应参数


名称 类型 短信接口示例值 描述
HTTP短信接口返回值 String <?xml version="1.0" encoding="utf-8" ?> <returnsms> <returnstatus>status</returnstatus> <message>message</message> <payinfo>payinfo</payinfo> <overage>overage</overage> <sendTotal>sendTotal</sendTotal> </returnsms> 返回状态值/返回信息提示/返回支付方式/返回余额/返回总点数


短信接口请求实例




状态码解释


状态码 状态描述
返回空 查询成功
将返回相应的支付方式、账户使用条数、总充值点数
用户名或密码不能为空 提交的用户名或密码为空
用户名或密码错误 表示用户名或密码错误