检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果 父主题: 应用、签名、模板
01 了解 了解短信的签名、模板和变量规范及短信发送规则,有助于您正确使用消息&短信服务。 产品介绍 产品概述 签名规范 模板和变量规范 短信发送规则 03 使用 详细介绍使用消息&短信的使用方法,并提供调用API发送短信的代码样例。 用户指南 资源介绍 创建短信应用 申请短信签名 申请短信模板
signature_source 是 Integer 签名来源。支持枚举值: 0:企事业单位的全称或简称 1:工信部备案网站的全称或简称 2: APP应用的全称或简称 3:公众号或小程序的全称或简称 4:电商平台店铺名的全称或简称 5:商标名的全称或简称 signature_type 是 String 签名类型。支持枚举值:
开发准备 国内短信开发数据准备 国内短信启动开发前需要准备的数据如下: 参数名 取值样例 获取方式 相关文档 APP_Key c8RWg3gg*********4bf3Y7x1Ile 登录管理控制台,从国内短信“应用管理”页面获取。 创建短信应用 APP_Secret q4Ii8
停用消息&短信服务,还会产生费用吗? 停用消息&短信服务,不会产生费用。如果您不再使用消息&短信服务,可以联系华为云客服将应用暂停。未到期的短信套餐包不支持退订、延期或暂停,建议您在套餐包到期后申请应用暂停。 父主题: 产品规格
返回结果 状态码 状态码是一组从2xx到4xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息 对应请求消
响应SmsSignatureResp参数中的ID project_id 是 String 项目ID,参考“获取帐号、用户、项目的名称和ID” 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json;charset=utf8
String 应用主键ID,参考表5 响应SmsAppQueryResp参数中的ID。 brackets 否 String 中括号类型。支持枚举值: CN:中文类型【】 GB:英文类型 [] 须知: 默认值为:CN。 输入值不在上述枚举值范围内的,也按CN处理。 只有地域为国内时,该字段有效。
模板主键ID,对应表5中的id project_id 是 String 项目ID,参考“获取帐号、用户、项目的名称和ID” 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json
com:443/sms/batchSendSms/v1"; //APP接入地址(在控制台"应用管理"页面获取)+接口访问URI // 认证用的appKey和appSecret硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;
响应消息头中X-Subject-Token的值) 最小长度:1 最大长度:32768 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json;charset=utf8 缺省值:application/json;charset=utf8
String 无 用于消息鉴权的哈希码,开启推送AKSK鉴权后携带。 格式为:SDK-HMAC-SHA256 Access= app_key的值, SignedHeaders=参与签名的头域(小写), Signature=经过签名算法计算得到的值 具体计算方式请参考添加签名信息到请求头。
请求体参数类型,该字段必须设置为:application/json;charset=utf8 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 响应参数 状态码: 200 表4
X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 表4 FormData参数 参数 是否必选 参数类型 描述 file 是 File 营业执照文件 响应参数 状态码: 200 表5 响应Body参数
String 无 用于消息鉴权的哈希码,开启推送AKSK鉴权后携带。 格式为:SDK-HMAC-SHA256 Access= app_key的值, SignedHeaders=参与签名的头域(小写), Signature=经过签名算法计算得到的值 具体计算方式请参考添加签名信息到请求头。
响应SmsSignatureResp参数中的ID project_id 是 String 项目ID,参考“获取帐号、用户、项目的名称和ID” 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json;charset=utf8
获取账号、用户、项目的名称和ID 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID 在华为云首页右上角,单击“控制台”。 在右上角的用户名中选择“我的凭证”。 图1 进入我的凭证 在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。
使用SDK发送短信样例 华为云MSGSMS开发工具包(SDK) 应用、签名、模板 Java huaweicloud-sdk-java-v3 Java SDK使用指导 使用SDK创建、更新及查询短信应用样例 使用SDK创建、查询及删除短信模板样例 使用SDK创建、查询及删除短信签名样例 华为云MSGSMS开发工具包(SDK)
获取终端节点 消息&短信终端节点如下表所示: 参数 描述 Endpoint Web 消息&短信当前可用Endpoint: 华北-北京四:msgsms.cn-north-4.myhuaweicloud.com 华南-广州:msgsms.cn-south-1.myhuaweicloud
而“状态码”为除DELIVRD外的其他值。 “发送结果”显示“发送中”,表示短信已发送,状态报告未返回的状态。短信平台发送短信成功后,最多72小时会推送状态报告给客户。 查询结果默认按每页10条数据分页展示。 您还可导出发送记录。 导出的表格中的字段说明如下: 参数 说明 是否收费