请求地址
名称 | 是否必须 | 示例值 | 说明 |
---|---|---|---|
请求地址 | UTF-8 | 地址一:http://sms.coreshop.cn:9999/sms.aspx 地址二:http://sms.corecms.net:9999/sms.aspx | 如果服务器不支持解析, 将sms.coreshop.cn改为101.201.41.194 |
请求参数
名称 | 是否必须 | 示例值 | 描述 |
---|---|---|---|
action | 必须 | 固定设置为:send | 任务命令为:短信发送 |
account | 必须 | ceshi | 注册获取;平台登陆账号。 请联系客服开通账号权限 |
password | 必须 | 123456 | 注册获取;平台登陆密码。 请联系客服开通账号权限 |
userid | 必须 | 1001 | 注册获取,登陆后台,在客户管理-我的信息中查看 |
mobile | 必须 | 13000000000,13000000001 | 短信接收号码。支持单个或多个手机号码,传入号码为11位手机号码,不能加0或+86。群发短信需传入多个号码,以英文逗号分隔,一次调用最多传入200个号码。示例:13000000000,13000000001 |
content | 必须 | 【核心商城系统】您的验证码是:123456 | 发送短信的内容,整体做urlencode.短信的格式为:【签名】放在内容的最前方。 示范:【核心商城系统】您本次注册的验证码是:888888, 其中“签名”可根据自己公司的名称或简称自定义,字数为2-8字,不可以是纯数字、电话号码或者网址,不可以是无意义的签名,比如“大家好”“哈哈哈”“提示”等 正确示例:【核心商城系统】、【京东】、【百度】、【糯米团购】 错误示例:【你好】、【通知】、【测试一下】、【哈哈哈】、【123123】 |
sendtime | 可选 | 2000-12-31 00:00:10 | 短信定时发送时间。不设置默认为立即发送。格式为:YYYY-MM-DD HH:MM:SS |
rt | 可选 | json | 返回值格式,默认为xml |
响应实例
响应实例-xml |
---|
|
响应实例-json |
---|
|
响应参数
名称 | 含义 | 示例值 | 描述 |
---|---|---|---|
returnstatus | 调用结果 | success | 调用结果:success为成功,faild为失败 |
message | 调用信息 | OK | 调用成功返回OK,失败显示失败原因,具体原因见下表 |
remainpoint | 账户余额 | 100 | 账户余额 |
taskID | 任务序号 | 100001 | 每次任务对应唯一的任务id |
successCounts | 号码个数 | 1 | 发送号码的个数 |
返回信息
示例值 | 描述 |
---|---|
OK | 提交成功 |
用户名或密码不能为空 | 提交的用户名或密码为空 |
发送内容包含sql注入字符 | 包含sql注入字符 |
用户名或密码错误 | 用户名或密码错误 |
余额不足 | 短信余额不足 |
实现代码一(HttpWebRequest
):
HttpWebRequest实现 |
---|
|
实现代码二(基于第三方组件):
需安装Flurl.Http 组件 |
---|
|
短信类问题
1、短信显示号码及显号规则?
手机端接收显示的号码是106开头的正规号码 显号规则:
a.号码=通道号+扩展码;
b.在通道不稳定、网络抖动及机房断电等不可抗拒的因素下,为确保到达率及到达时间,会自动切换通道,通道号会发生变化。
2、短信提供哪些功能?
目前支持短信下行发送、回复获取、短信状态报告回执、帐单/报表查询等;
短信回复功能免费,但上行产生的通讯费,由运营商向用户收取.
3、短信发送成功,但实际未能收到短信是什么原因?
手机是不是长时间不关机,可以关机重启下
手机收件箱是不是已满,删除一些看是否可以正常接收
手机是不是双卡双待的手机,把卡拿出来换一下卡槽
手机是不是安装了安全软件,安全软件有可能会进行拦截到垃圾信箱里
如若不行,请您将SIM卡换到其他手机上进行测试。
4、短信发送状态回执哪里查看?
短信管理-我的状态报告
5、短信三网都可发送吗,能发送海外/港澳台吗?
支持三网发送,目前海外/港澳台暂不支持,敬请期待。
6、短信字数最多能发多少个字?
最大支持发送300个字以内的短信。(若长短信发送失败请联系技术支持)
7、变量中可直接写链接吗?
建议将已ICP备案的网址写于短信模板非变量内容中,审核通过后可发送;
8、短信条数的计算规则是什么?
短信计费方面是有行业统一的标准:70字一条,长短信67字计一条,最多可以发300字,这个是所有短信(包括手机发送短信)统一的计费标准;
例如:发70字计费一条、发71字计费两条、发134字计费两条、发135字计费3条;
其中与编程不同的是,汉字、字母、数字、标点均计为一个字符,不分全角半角。在短信后台编辑短信界面,平台有字符数量以及计费条数提示。
技术类问题
1、接口返回报错及其解决办法
接口返回值:非法签名 解决办法:联系客服为您报备一下就可以了,1分钟就可以完成哦
接口返回值:短信必须带【】格式签名 原因及其解决办法:发送内容格式没有签名,如果已经有签名仍然返回,那就是内容编码格式不正确 解决办法:content字段使用utf-8 urlencode编码
接口返回值success但是手机未接收到短信,请提供接口返回的taskid或者测试使用的手机号联系客服,查找原因
2、同一号码发送频率是怎样的?
为避免频繁发送给客户造成不良影响,运营商针对相同号码发送频率:半小时5次,一天内10次,如需要更多频率请联系客服
3、怎样防止短信验证码被恶意点击?
用户恶意点击手机短信验证码,不仅会增加公司的运营成本,一般短信都会带公司的签名,也会给公司的形象造成极坏的影响,所以必须要对这种行为进行防范,目前,防范的手段主要有以下几个方面:
1.IP限定——根据自己的业务特点,设置每个IP每天的最大发送量
2.短信发送间隔设置——设置同一号码重复发送的时间间隔,一般设置为60-120秒
3.手机号码限定——根据业务特点,设置每个手机号码每天的最大发送量
4.绑定图型校验码——将图形校验码和手机验证码进行绑定,这样能比较有效的防止软件恶意注册。
5.流程限定——将手机短信验证和用户名密码设置分成两个步骤,用户在设置成功用户名密码后,下一步才进行手机短信验证,并且需要在获取第一步成功的回执之后才可进行校验。