检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用发送短信API或发送分批短信API时,可使用templateParas参数填充变量。 “templateParas”参数用于依次填充“templateId”参数指定的模板内容中的变量,该参数需填写为JSONArray格式。请参考模板规范和变量规范。
、用户、项目的名称和ID” 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json X-Auth-Token 是 String 用户Token。
若“templateId”指定的模板为无变量模板,则请求无需携带“templateParas”参数;若携带了该参数,请置空。 当时间变量需要同时指定日期和时间时,请检查模板中是否将日期和时间配置为两个变量,一个变量传入日期,另一个变量传入时间。不要将日期和时间合成一个变量。
调用发送短信API和发送分批短信API时,请求参数“to”用于填写短信接收方的号码,标准号码格式为:+{国家码}{地区码}{终端号码}。 发送国内短信,如果“+{国家码}”不存在,则默认为+86,如果接收方号码为手机号码,则{地区码}可选。如:+86131****5678。
发送短信API中,模板变量参数“templateParas”的类型没有设置为字符串。 您可以将“templateParas”参数必须设置为字符串形式修复这个问题。请参考以下代码样例填写,或前往代码样例查看。
如果需要按应用区分上行短信,可以通过如下方式实现: 创建国内短信应用时,针对不同的应用,配置不同的上行短信接收地址; 如果多个短信应用配置了同一个上行短信接收地址,请通过上行短信通知中“to”参数携带的上行短信接收方号码(即通道号)匹配签名名称,并通过签名名称所属应用实现区分。
请查看短信状态报告中的“status”参数取值是否为“DELIVRD”,即短信发送成功。 若“status”参数取值非“DELIVRD”: 若取值为“LIMIT”或者“BEYONDN”,请联系客服确认是否短信发送频率达到上限。
发送短信 发送分批短信 上表中的参数,除“访问URI”为固定值外,其他参数请根据对应的获取方式到控制台获取,取值样例仅为示例。 准备的数据与短信API请求参数关联关系如下: 如有任何疑问,请联系华为云智能客服,将有专人为您解答。
查看调用发送短信/发送分批短信API接口的响应消息,确认关键参数取值如下: 一个请求响应只对应一个code,一个手机号码对应一个status。 参数 取值 说明 code 000000 表示请求成功,请查看“status”取值。
客户调用短信业务API发送短信时,通过“statusCallback”参数携带该地址。消息&短信服务通过回调该地址,向客户推送已发送短信的状态报告通知。
请参考代码样例,确认参数均以正确的格式携带。 请确认短信接收方号码中无重复号码,且号码都为可接受短信的状态(不是空号或停机的号码)。 请勿在一天内向同一个用户发送太多条短信,详情请参见短信发送规则。 父主题: 短信发送相关
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json X-Auth-Token 是 String 用户Token。
参数 说明 套餐包类型 分为推广短信和行业短信(验证码短信和通知短信)两种类型。 规格 超出当前套餐包的额度或使用时段,将自动转为按需计费。 已购买套餐包不支持退订和修改,请根据实际业务量,选择合适的规格。
通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 表4 FormData参数 参数 是否必选 参数类型 描述 file 是 File 营业执照文件 响应参数 状态码: 200 表5 响应Body参数 参数 是否必选 参数类型 描述 file_id
发送国内短信前,需要准备的数据与短信API请求参数之间的对应关系,请参考开发准备(国内短信)。 通用模板,即所属签名为通用签名的模板,可供同应用下的同业务类型的所有签名使用。验证码类、通知类和推广类短信均可以使用通用模板。
若用户发送短信时未携带extend参数,则状态报告中也不会携带extend参数。
URI GET /v2/{project_id}/msgsms/upload-files 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,参考“获取帐号、用户、项目的名称和ID” 表2 Query参数 参数 是否必选 参数类型 描述
本文提供了消息&短信API的描述、参数说明及示例等内容,带您一步一步使用消息&短信服务API。 全部API操作指引,请参见API概况。 在调用API前,请确保您已经充分了解消息&短信相关概念,详细信息请参见消息&短信产品介绍。
请检查from参数传递的通道号对应的签名和templateId参数对应的签名是否一致。如果是通用模板(所属签名为通用签名),则必须携带签名名称(signature参数)。 华为平台 E200021 国内短信签名匹配通道失败。 应用未配置通道。
URI GET /v2/{project_id}/msgsms/apps-count 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,参考“获取帐号、用户、项目的名称和ID” 表2 Query参数 参数 是否必选 参数类型 描述 region