文档首页 > > API参考> API> 短信操作> 批量发送推广类短信

批量发送推广类短信

分享
更新时间: 2019/09/16 GMT+08:00

功能介绍

  • 接口名称

    PromotionSmsPublish

  • 功能描述

    批量发送推广短信给指定手机号码数组

URI

  • URI格式

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

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID

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

请求消息

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    sms_template_id

    String

    短信模板的唯一标识,可通过查询短信模板获取。

    endpoints

    String列表

    手机号码的列表

    终端节点必须是一个电话号码,国际号码必须以“+[国家码]”开头,国内号码可以省略“+”或“+[国家码]”。手机号码个数不能超过1000。

    说明:

    列表内的手机号码在发送时会进行去重,去重规则是“字符串完全匹配”。比如,18888888888与+8618888888888会被识别为两个号码,不会被去重。

    sign_id

    String

    签名ID

    短信签名ID在创建短信签名时由系统自动生成,是短信签名的唯一标识。请在SMN控制台左侧导航栏单击“短信”,在页面的短信签名列表中获取签名ID。已关联签名的短信模板该参数不需要填写。

    extend_code

    String

    扩展字段,短信状态通知时,会返回该字段内容,长度小于等于32个字节。

    extend_src_id

    String

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

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

  • 请求样例
    POST https://{SMN_Endpoint}/v2/{project_id}/notifications/sms/promotion 
    {
        "endpoints":[ "18676696912", "18676696913","18246161627","18246161627"],
        "sms_template_id": "1dd49958037a47e2bd2313ed04628638",
        "sign_id": "5dd49958037a47e2bd2313ed04628638"
    }

响应消息

  • 要素说明

    名称

    参数类型

    说明

    request_id

    String

    请求的唯一标识ID。

    result

    Sms_commit_result结构体列表

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

    表1 提交成功_Sms_commit_result结构体

    名称

    参数类型

    说明

    message_id

    String

    唯一的消息ID

    endpoint

    String

    手机号码

    表2 提交失败_Sms_commit_result结构体

    名称

    参数类型

    说明

    endpoint

    String

    手机号码

    code

    String

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

    message

    String

    错误提示信息

  • 响应样例
    { 
        "request_id": "9974c07f6d554a6d827956acbeb4be5f",
        "result": [
              {
                    "message_id": "bf94b63a5dfb475994d3ac34664e24f2", 
                    "endpoint": "8615911119348
              },
              {
                    "code": "SMN.0087",
                    "message": "The SMS message signature has not been approved.", 
                    "endpoint": "8615921119348"
              }
         ]  
    }

返回值

请参考返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区