我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业通信保驾护航!

当前位置:首页>帮助与支持>API指南>短信发送

短信发送

请求地址

名称 是否必须 示例值 说明
请求地址 UTF-8 http://www.smsok.com.cn/sms.aspx 如果服务器不支持解析,将域名改为IP

action

名称 是否必须 示例值 说明
必须 固定设置为:send 任务命令为:短信发送
account 必须 karlos_ceshi 注册获取;平台登陆账号。 点此注册>>
password 必须 123456
userid 必须 1001 登陆后台,在客户管理-我的信息中查看。
mobile 必须 18030181186,18030181186 短信接收号码。支持单个或多个手机号码,传入号码为11位手机号码,不能加0或+86。群发短信需传入多个号码,以英文逗号分隔,一次调用最多传入1000个号码。示例:18030181186,18030181186
content 必须 【卡洛思】您本次的验证码:1231,请及时填写。 短信签名的格式为:【签名】放在内容的最前方。示范:【卡洛思】您本次的验证码:1231,请及时填写。, 其中“签名”可根据自己公司的名称或简称自定义,字数为2-8字,不可以是纯数字、电话号码或者网址,不可以是无意义的签名,比如“测试一下”“试用”“提示”等 正确示例:【卡洛思】、【百度】、【糯米团购】 错误示例:【你好】
sendtime 可选 2009-12-31 00:00:10 短信定时发送时间。不设置默认为立即发送。格式为:YYYY-MM-DD HH:MM:SS

例如:http://www.smsok.com.cn/sms.aspx?action=send&userid=102&account=acc&password=pass&mobile=18030181186&content=【卡洛思】您本次的验证码:1231,请及时填写。

响应实例

响应实例
<xml version="1.0" encoding="utf-8" >    <returnsms>    <returnstatus>status</returnstatus>    <message>message</message>    <remainpoint> remainpoint</remainpoint>    <taskID>taskID</taskID>    <successCounts>successCounts</successCounts>    </returnsms>

响应参数

名称 含义 示例值 描述
returnstatus 调用结果 success 调用结果:success为成功,faild为失败
message 调用信息 OK 调用成功返回OK,失败显示失败原因,具体原因见下表
remainpoint 账户余额 100 账户余额
taskID 任务序号 112001 每次任务对应唯一的任务id
successCounts 号码个数 1 发送号码的个数

返回信息

示例值 描述
OK 提交成功
用户名或密码不能为空 提交的用户名或密码为空
发送内容包含sql注入字符 包含sql注入字符
用户名或密码错误 提交的被叫号码为空
余额不足 短信余额不足