阿里云平台发送短信

发布时间:2019-10-14 09:20:47编辑:auto阅读(2331)

    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查询具体的发送状态

    3.接口的下载

    1. SDK下载
    2. 执行:

      • 安装依赖:进入根目录执行命令: 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)

关键字