文档首页 > > API参考> API> 短信操作> 批量发送不同内容的推广类短信

批量发送不同内容的推广类短信

分享
更新时间: 2019/11/19 GMT+08:00

功能介绍

  • 接口名称

    PromotionSmsBatchPublishWithDiffMessage

  • 功能描述

    批量发送具有不同消息内容的推广类短信。

该接口当前有权限控制,如需使用请联系客服申请。

URI

  • URI格式

    POST /v2/{project_id}/notifications/sms/promotion

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID

    获取项目ID请参考获取项目ID

请求消息

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    sms_message

    Sms_message结构体列表

    待发送短信的详情,结构体说明请参见表1

    待发送的短信数量小于1000。

    表1 Sms_message结构体

    名称

    是否必选

    参数类型

    说明

    约束

    endpoint

    String

    手机号码

    终端节点必须是一个电话号码,国际号码必须以“+[国家码]”开头,国内号码可以省略“+”或“+[国家码]”。

    message

    String

    消息内容

    长度不超过490个字符。如果传递sign_id参数,则message中不需要携带签名,系统会自动拼接签名信息于message头部。如果传递message_include_sign _flag参数,则message的签名信息由用户拼接。将签名放置于“【】”括号中,并添加到内容头部。例如:“【XX商城】您的验证码为123456,请尽快完成验证。”

    sign_id

    当message_include_sign_flag参数不传递或为“false”时,此参数必选

    String

    签名ID

    短信签名ID在创建短信签名时由系统自动生成,是短信签名的唯一标识。请在SMN控制台左侧导航栏单击“短信”,在页面的短信签名列表中获取签名ID,参考查询短信签名

    -

    message_include_sign_flag

    当sign_id参数不传递时,此参数必选且为“true”

    String

    如果您需要在message中自行拼接签名信息,请将此参数设置为"true"。

    "true" 或 "false",不传参数则默认为"false"。

    extend_src_id

    String

    短信发送方号码的扩展号码

    8位以内的数字。该字段仅限可自定义扩展号码的签名使用。

    extend_code

    String

    扩展字段,短信状态通知时,会返回该字段内容。

    长度小于等于32个字节

  • 请求样例
    POST https://{SMN_Endpoint}/v2/f96188c7ccaf4ffba0c9aa149ab2bd57/notifications/sms/promotion
    {     
          "sms_message": [         
              {                
                    "endpoint":"86159****9348",                
                    "message": "Sms messagetest" ,              
                    "sign_id":"caf488c7ccaf4ffba0c9aa149ab2caf4",              
                    "message_include_sign_flag": "false"          
              },          
              {              
                   "endpoint":"86159****9348",                
                   "message": "【Signname】Sms message test" ,              
                   "message_include_sign_flag": "true"          
              }      
        ]
    }

响应消息

  • 要素说明

    名称

    参数类型

    说明

    request_id

    String

    请求的唯一标识ID

    result

    Promotion_sms_commit_result结构体列表

    返回用户发送电话号码详情。结构体说明请参见表2表3

    表2 提交成功_Promotion_sms_commit_result结构体

    名称

    参数类型

    说明

    message_id

    String

    唯一的消息ID

    endpoint

    String

    手机号码

    表3 提交失败_Promotion_sms_commit_result结构体

    名称

    参数类型

    说明

    endpoint

    String

    手机号码

    code

    String

    错误码,请参考错误码说明

    message

    String

    错误提示信息

    sensitive_word

    String

    内容中包含的敏感关键词

  • 响应样例
    {     
        "result": [         
            {             
                "endpoint": "1824*****627",            
                "code": "SMN.227",            
                "message": "Parameter: The message contains sensitive words.",
                "sensitive_word": "xxxx"        
            },         
            {             
                "endpoint": "1867****912",             
                "message_id": "0f77847fe8cf47b18fba5def14d5b21e"         
            }    
        ],     
        "request_id": "29bac33ba85c48418632158a9036231a"
    }

返回值

请参考返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区