摘要:获取阿里云访问密钥为了使用短信发送,您必须申请阿里云的访问密钥。国际港澳台消息只能使用国际港澳台短信模版发送短信。
1.获取阿里云访问密钥
为了使用短信发送API-Python SDK,您必须申请阿里云的访问密钥。
阿里云访问秘钥是阿里云为用户使用 API(非控制台)来访问其云资源设计的“安全口令”。您可以用它来签名 API 请求内容以通过服务端的安全验证。
该访问秘钥成对(AccessKeyId 与 AccessKeySecret)生成和使用。每个阿里云用户可以创建多对访问秘钥,且可随时启用(Active)、禁用(Inactive)或者删除已经生成的访问秘钥对。
您可以通过阿里云控制台的 秘钥管理页面 创建、管理所有的访问秘钥对,且保证它处于“启用”状态。由于访问秘钥是阿里云对 API 请求进行安全验证的关键因子,请妥善保管你的访问秘钥。如果某些秘钥对出现泄漏风险,建议及时删除该秘钥对并生成新的替代秘钥对。
2.在控制台完成模板与签名的申请,获得调用接口必备的参数短信签名
根据用户属性来创建符合自身属性的签名信息。企业用户需要上传相关企业资质证明,个人用户需要上传证明个人身份的证明。
短信签名需要审核通过后才可以使用。
短信模板
短信模板,即具体发送的短信内容。
短信模板可以支持验证码、短信通知、推广短信、国际/港澳台消息四种模式。验证码和短信通知,通过变量替换实现个性短信定制。推广短信不支持在模板中添加变量。国际/港澳台消息只能使用国际/港澳台短信模版发送短信。
短信模板需要审核通过后才可以使用。
3.参数列表 入参列表参数名称 | 参数类型 | 必填与否 | 样例取值 | 参数说明 |
---|---|---|---|---|
PhoneNumbers | String | 必须 | 15000000000 | 短信接收号码。支持以逗号分隔的形式进行批量调用,批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式,发送国际/港澳台消息时,接收号码格式为00+国际区号+号码,如“0085200000000” |
SignName | String | 必须 | 云通信 | 短信签名 |
TemplateCode | String | 必须 | SMS_0000 | 短信模板ID,发送国际/港澳台消息时,请使用国际/港澳台短信模版 |
TemplateParam | String | 可选 | {“code”:”1234”,”product”:”ytx”} | 短信模板变量替换JSON串,友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含rn的情况在JSON中需要表示成rn,否则会导致JSON在服务端解析失败 |
OutId | String | 可选 | abcdefgh | 外部流水扩展字段 |
出参名称 | 出参类型 | 样例取值 | 参数说明 |
---|---|---|---|
RequestId | String | 8906582E-6722 | 请求ID |
Code | String | OK | 状态码-返回OK代表请求成功,其他错误码详见错误码列表 |
Message | String | 请求成功 | 状态码的描述 |
BizId | String | 134523^4351232 | 发送回执ID,可根据该ID查询具体的发送状态 |
SDK下载
执行:
安装依赖:进入根目录执行命令: python setup.py install #如果为python3,请执行:python3 setup.py install
修改信息:从阿里云控制台上获取ACCESS_KEY_ID与ACCESS_KEY_SECRET,并填入文件const.py中
运行程序:python demo_sms_send.py #如果为python3,请执行python3 demo_sms_send.py
pip install aliyun-python-sdk-core-v3==2.8.6,2.9版本的region_provider没有add_endpoint属性
注意:您还需要在控制台上申请短信模板,并将相关信息填入至文件demo_sms_send.py中
错误码列表Code | 描述 |
---|---|
OK | 请求成功 |
isp.RAM_PERMISSION_DENY | RAM权限DENY |
isv.OUT_OF_SERVICE | 业务停机 |
isv.PRODUCT_UN_SUBSCRIPT | 未开通云通信产品的阿里云客户 |
isv.PRODUCT_UNSUBSCRIBE | 产品未开通 |
isv.ACCOUNT_NOT_EXISTS | 账户不存在 |
isv.ACCOUNT_ABNORMAL | 账户异常 |
isv.SMS_TEMPLATE_ILLEGAL | 短信模板不合法 |
isv.SMS_SIGNATURE_ILLEGAL | 短信签名不合法 |
isv.INVALID_PARAMETERS | 参数异常 |
isp.SYSTEM_ERROR | 系统错误 |
isv.MOBILE_NUMBER_ILLEGAL | 非法手机号 |
isv.MOBILE_COUNT_OVER_LIMIT | 手机号码数量超过限制 |
isv.TEMPLATE_MISSING_PARAMETERS | 模板缺少变量 |
isv.BUSINESS_LIMIT_CONTROL | 业务限流 |
isv.INVALID_JSON_PARAM | JSON参数不合法,只接受字符串值 |
isv.BLACK_KEY_CONTROL_LIMIT | 黑名单管控 |
isv.PARAM_LENGTH_LIMIT | 参数超出长度限制 |
isv.PARAM_NOT_SUPPORT_URL | 不支持URL |
isv.AMOUNT_NOT_ENOUGH | 账户余额不足 |
注:查询所有错误码及解决办法请点击短信接口调用错误码
4.短信发送demo# -*- coding: utf-8 -*- # import sys from aliyunsdkdysmsapi.request.v20170525 import SendSmsRequest from aliyunsdkdysmsapi.request.v20170525 import QuerySendDetailsRequest from aliyunsdkcore.client import AcsClient import uuid from aliyunsdkcore.profile import region_provider from aliyunsdkcore.http import method_type as MT from aliyunsdkcore.http import format_type as FT import const """ 短信业务调用接口示例,版本号:v20170525 Created on 2017-06-12 """ # 这里setdefaultencoding为utf8设置默认编码为utf-8,但是现在可能由于版本原因会出错 # try: # reload(sys) # sys.setdefaultencoding("utf8") # except NameError: # pass # except Exception as err: # raise err # 注意:不要更改 REGION = "cn-hangzhou" PRODUCT_NAME = "Dysmsapi" DOMAIN = "dysmsapi.aliyuncs.com" #ACCESS_KEY_ID 和ACCESS_KEY_SECRET要传入 acs_client = AcsClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET, REGION) region_provider.add_endpoint(PRODUCT_NAME, REGION, DOMAIN) #这里写入自己的签名和模板,后面调用就不用写了 def send_sms(business_id, phone_numbers,template_param=None,sign_name="***",template_code="***"): smsRequest = SendSmsRequest.SendSmsRequest() # 申请的短信模板编码,必填 smsRequest.set_TemplateCode(template_code) # 短信模板变量参数 if template_param is not None: smsRequest.set_TemplateParam(template_param) # 设置业务请求流水号,必填。 smsRequest.set_OutId(business_id) # 短信签名 smsRequest.set_SignName(sign_name) # 数据提交方式 # smsRequest.set_method(MT.POST) # 数据提交格式 # smsRequest.set_accept_format(FT.JSON) # 短信发送的号码列表,必填。 smsRequest.set_PhoneNumbers(phone_numbers) # 调用短信发送接口,返回json smsResponse = acs_client.do_action_with_exception(smsRequest) # TODO 业务处理 return smsResponse if __name__ == "__main__": __business_id = uuid.uuid1() #print(__business_id) params = "{"code":"12345","product":"云通信"}" #params = u"{"name":"wqb","code":"12345678","address":"bz","phone":"13000000000"}" print(send_sms(__business_id, "13000000000", params)) 阿里短信发送短信时返回这个信息,之前是可以发送的,现在阿里应该是做了限制的。如果你的短信模板类型为“验证码”,发送的短信内容只能是包含字母和数字 所以当你的短信内容包含特殊符号和中文时,请把短信模板类型修改为“通知”,这里只能新增一个模板了,因为短信模板目前没有修改。5.接口的调用
class SmsCodeViewset(mixins.CreateModelMixin,viewsets.GenericViewSet): """ 手机验证码 """ serializer_class = SmsSerializer def generate_code(self): """ 生成四位数字的验证码 """ str1 = "" for i in range(4): str1 += str(random.randint(0,9)) return str1 def create(self, request, *args, **kwargs): serializer = self.get_serializer(data=request.data) # 验证合法 serializer.is_valid(raise_exception=True) mobile = serializer.validated_data["mobile"] code = self.generate_code() params = {"code":code} sms_status = demo_sms_send.send_sms(uuid.uuid1(),mobile,params) #字节转字符串 sms_status = sms_status.decode() #字符串转字典 sms_status = eval(sms_status) if sms_status["Code"] != "OK": return Response({ "mobile": sms_status["Message"] }, status=status.HTTP_400_BAD_REQUEST) else: code_record = VerifyCode(code=code, mobile=mobile) code_record.save() return Response({ "mobile": mobile }, status=status.HTTP_201_CREATED)
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/42272.html
摘要:了解更多场景如何玩如何将变现请下载阿里云免费下载用到的阿里云提供的语音服务短信服务邮件服务等。只需开通邮件推送服务,调用,就可以快速将邮件通知给多达人。 摘要: 钉钉是企业IM市场上的领先者,深受中小企业客户的喜欢,就再几天前刚刚宣布用户数超过1亿!在钉钉里面有个特别实用的功能,那就是Ding一下,如果你发的消息特别紧急,可以直接通过短信、电话等方式直接通知到接收人的手机上。 点此查看...
摘要:一安装拓展地址二拓展配置阿里云阿里云三实现短信发送单条短信发送单条发送短信签名短信签名短信模板编号短信接收者模板变量发送短信流水号,选填多条短信发送批量发送签名手机号模板字段数组长度必须相等短信签名短信签名短信签名短信模板编号 一:安装saviorlv/yii2-dysms拓展 composer地址:https://packagist.org/package... composer r...
摘要:今天快哥带大家来看下阿里云的云通信产品,和域名与网站产品一样,也是老树开新花。云通信产品主要包括短信服务语音服务流量服务消息服务邮件推送。手机对手机的模式,在实时通讯软件中已经帮我们解决了,并不在阿里云通信产品中。今天快哥带大家来看下阿里云的云通信产品,和域名与网站产品一样,也是老树开新花。快哥科普完保证你能了解掌握,也是以后和别人讨论的素材。 云通信产品是之前运营商的产品,现在被阿里、腾讯...
阅读 896·2019-08-30 15:54
阅读 1465·2019-08-30 15:54
阅读 2398·2019-08-29 16:25
阅读 1291·2019-08-29 15:24
阅读 747·2019-08-29 12:11
阅读 2505·2019-08-26 10:43
阅读 1226·2019-08-26 10:40
阅读 464·2019-08-23 16:24