- API
- 发送短信
- 添加模板
- 模板状态查询
- 状态报告查询
- 模板列表
GET/sms/sendv2
无参数
无参数
- 接口文档
- 请求示例
- 成功响应
- 失败响应
- 错误码
- 调用结果
接口信息
https://zwp.market.alicloudapi.com/sms/sendv2
GET
JSON
API 简单身份认证调用方法(APPCODE)API 签名认证调用方法(AppKey & AppSecret)
接口参数
请求参数(Header)
字段名称 | 必填 | 字段详情 |
---|---|---|
无参数 |
请求参数(Query)
字段名称 | 必填 | 字段详情 |
---|---|---|
mobile string | Y | 接收短信的手机号码 实例值: 1343994XXXX |
content string | N | 发送内容,如果是get,在url请求,内容需要url编码,注:发送之前需要先在添加模板子接口中设定模板,待模板审核通过后再提交发送,内容需和已审核通过的模板除了变量部分,其余部分全部一致 实例值: 【智能云】您的验证码是568126。如非本人操作,请忽略本短信 |
请求参数(Body)
字段名称 | 必填 | 字段详情 |
---|---|---|
无参数 |
商品介绍
产品亮点
产品说明
短信验证码,三网短信验证码,短信验证码接口,验证码短信,短信验证码API,会员短信,短信API,支持携号转网,短信接口对接API服务
一、相关注意事项
1.为积极配合运营商治理垃圾短信,按运营商要求,运营商将有投诉记录或回复退订的手机号加入黑名单。如黑名单对您的用户使用有影响,可联系在线客服咨询。
2.[重要] 验证码客户请务必添加图片验证码等防恶意攻击的机制,以防短信轰炸。
3.发送频率:验证码同1个号码同1个签名的内容30秒内只能发2条,1分钟内只能发4条,30分钟内只能发5条,过快的频率可能会导致运营商系统屏蔽,用户无法正常接收
4.短信签名:3到8个字符,应用名称或者公司名称,不能含有特殊字符,如:符号、空格
5.短信内容:不能含有中括号,以及推销电话和链接
6.字数限制:短信内容(包含签名)小于等于70个字符为计费1条。超过70个字符为长短信,按每67个字符计费1条,中英文标点空格都算作一个字符,最多300字符。
二、基本使用流程
1.选择相应的套餐
2.申请短信模板
2.1、已经提供了几个常用的模板格式示例供参考,如果开发者还不能满足开发作者实际的需求,您可以自行添加(添加成功后会获得一个模板ID,用于请求API时使用),待审核通过后即可使用自定义模板发送短信,目前短信API服务暂只支持验证码类、通知类信息,不支持营销类,订阅类,邀请类短信都不能发送,涉及黑关键词也不行,如房产,医疗等的短信内容,如不确定可与我们的在线客服联系确认。
2.2、为什么需要通过模板发送短信?由于运营商对短信内容有一定的监管,会有部分关键字不允许发送。通过模板发送的短信,由于模板提前由专业客服审核,短信内容被屏蔽的可能性非常小。 另外,由于模板已经审核过,使用模板发送不再需要重复做关键字检查,理论上速度会比普通发送的接口更快,非常适合内容相对固定、实时性要求高的触发类短信,如验证码的发送。
2.3、模板变量设置说明:定义一个变量统一格式为:#code#,#号中间的code用户可以自行定义。
3.短信发送API的使用
3.2、根据接口文档格式要求传递数据。个别参数的简易说明:
建议直接用简易发送方法,系统会自动判断当前账号下有没有审核通过的和发送内容相符合的模板。用户只需要提交短信发送的完整内容即可。
sms/sendv2?mobile=手机号&
content=urlencode(【云通知】您的验证码是123456。如非本人操作,请忽略本短信)
系统中如果有一条(eg:【云通知】您的验证码是#code#。如非本人操作,请忽略本短信) 的模板则会提交通过发送成功
二、注意事项
1. 次数扣减规则:
阿里云的次数扣减是根据http响应状态码来判断的,只有当http响应状态码为200-300时才会扣减次数,所以用户需要处理200之外的响应,获取响应json数据。http响应状态码对照表请参考https://help.aliyun.com/document_detail/43906.html
- 常见问题:
- 如何获取错误信息错误提示
https://help.aliyun.com/document_detail/43800.html
- 接口返回值为空
https://help.aliyun.com/document_detail/43790.html
3、错误代码表。
https://help.aliyun.com/document_detail/43906.html
3. 常见http响应状态码:
a. 如果appCode输入不正确会返回403,Unauthorized,appCode不能跨商品调用
b. 如果次数用完会返回403,Quota Exhausted,此时继续购买就可以
三、温馨提示
请及时到控制台设置余额提醒,以免影响业务开展。
四、常见问题
Q1调用接口返回http状态码403是什么原因?
答: 当调用接口返回http状态码为403时,一般是该接口的次数消耗完毕,被阿里云网关拦截了,建议检查剩余次数
Q2 同一产品,购买新的套餐后,appcode和key会变么?
答: App code不会变,一个账号对应一组Appcode和key,除非用户自己重置了
Q3发票一般多久可以开具?
答: 我司财务每周按批开具一次发票,普票会发送电子发票到您的预留手机号中和系统的下载地址,专票最晚5个工作日内会将纸质发票寄出,如遇特殊情况顺延。
Q4是否可以开具发票与阿里云的关联性证明?
答:可以,如若需要证明发票主体与购买的阿里云服务商的关联性,可联系客服,协助您开具证明。如果用第二种支付方式网商银行融易收是四流合一的不需要开具关联性证明,网商银行融易收就是平台为了解决四流合一。
Q5已购买的套餐在哪里查看剩余次数?是否可以设置余量提醒?
答: 已购买套餐使用情况查看路径“进入管理控制台—一已购买的服务一套餐包列表”;目前阿里云平台默认余量为20%,会定期发送短信和邮件提醒余量。
产品参数
交付方式 | API |
开票主体 | 北京互联三六五科技有限公司 |
所属类目 | 短信与运营商 |
上架日期 | 2020-02-20 |
产品截图
售后支持范围
商品价格(此处价格仅供参考,实际价格以选配后的价格为准)
版本名称 | 计费项 | 新购 |
3元/100次 | 版本基础价格 | 3元 |
35元/1000次【0.035元/次】 | 版本基础价格 | 35元 |
350元/10000次【0.035元/次】 | 版本基础价格 | 350元 |
680元/20000次【0.034元/次】 | 版本基础价格 | 680元 |
1650元/50000次【0.033元/次】 | 版本基础价格 | 1650元 |
3000元/100000次【0.03元/次】 | 版本基础价格 | 3000元 |
5999元/200000次【0.0299元/次】 | 版本基础价格 | 5999元 |
14750元/500000次【0.029元/次】 | 版本基础价格 | 14750元 |
29000元/1000000次【0.029元/次】 | 版本基础价格 | 29000元 |
57000/2000000【0.028元/次】 | 版本基础价格 | 57000元 |
275000/10000000【0.027元/次】 | 版本基础价格 | 275000元 |
联系客服私人定制单价 | 版本基础价格 | 0元 |
使用指南
立即下载客户案例
一、相关注意事项
1.为积极配合运营商治理垃圾短信,按运营商要求,运营商将有投诉记录或回复退订的手机号加入黑名单。如黑名单对您的用户使用有影响,可联系在线客服咨询。
2.[重要] 验证码客户请务必添加图片验证码等防恶意攻击的机制,以防短信轰炸。
3.发送频率:验证码同1个号码同1个签名的内容30秒内只能发2条,1分钟内只能发4条,30分钟内只能发5条,过快的频率可能会导致运营商系统屏蔽,用户无法正常接收
4.短信签名:3到8个字符,应用名称或者公司名称,不能含有特殊字符,如:符号、空格
5.短信内容:不能含有中括号,以及推销电话和链接
6.字数限制:短信内容(包含签名)小于等于70个字符为计费1条。超过70个字符为长短信,按每67个字符计费1条,中英文标点空格都算作一个字符,最多300字符。
二、基本使用流程
1.选择相应的套餐
2.申请短信模板
2.1、已经提供了几个常用的模板格式示例供参考,如果开发者还不能满足开发作者实际的需求,您可以自行添加(添加成功后会获得一个模板ID,用于请求API时使用),待审核通过后即可使用自定义模板发送短信,目前短信API服务暂只支持验证码类、通知类信息,不支持营销类,订阅类,邀请类短信都不能发送,涉及黑关键词也不行,如房产,医疗等的短信内容,如不确定可与我们的在线客服联系确认。
2.2、为什么需要通过模板发送短信?由于运营商对短信内容有一定的监管,会有部分关键字不允许发送。通过模板发送的短信,由于模板提前由专业客服审核,短信内容被屏蔽的可能性非常小。 另外,由于模板已经审核过,使用模板发送不再需要重复做关键字检查,理论上速度会比普通发送的接口更快,非常适合内容相对固定、实时性要求高的触发类短信,如验证码的发送。
2.3、模板变量设置说明:定义一个变量统一格式为:#code#,#号中间的code用户可以自行定义。
3.短信发送API的使用
3.2、根据接口文档格式要求传递数据。个别参数的简易说明:
建议直接用简易发送方法,系统会自动判断当前账号下有没有审核通过的和发送内容相符合的模板。用户只需要提交短信发送的完整内容即可。
sms/sendv2?mobile=手机号&
content=urlencode(【云通知】您的验证码是123456。如非本人操作,请忽略本短信)
系统中如果有一条(eg:【云通知】您的验证码是#code#。如非本人操作,请忽略本短信) 的模板则会提交通过发送成功
二、注意事项
1. 次数扣减规则:
阿里云的次数扣减是根据http响应状态码来判断的,只有当http响应状态码为200-300时才会扣减次数,所以用户需要处理200之外的响应,获取响应json数据。http响应状态码对照表请参考https://help.aliyun.com/document_detail/43906.html
2. 常见http响应状态码:
a. 如果appCode输入不正确会返回403,Unauthorized,appCode不能跨商品调用
b. 如果次数用完会返回403,Quota Exhausted,此时继续购买就可以
三、温馨提示
请及时到控制台设置余额提醒,以免影响业务开展。
服务商
北京互联三六五科技有限公司
- 数据与API
用户评论 (605)
还不错,准确!
有业务需求的话还会来你们家买的,好评。
确认服务是直连
售后服务很好,解答的很全面很仔细!
技术解答很专业
阿里云默认推荐的接口果然很好用,希望继续保持这个速度与稳定性!
比较了很多家,也咨询了不少,选择您家,是最稳定的,目前是很满意。
售后解答很及时
小额测试套餐性价比很高,好评
双十一活动很优惠,好评