检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
2022-10-28 第十一次正式发布。 本次变更如下: API文档结构优化,新增“使用前必读”、“API概况”、“如何调用API”与“附录”等章节。 2022-7-21 第十次正式发布。 本次变更如下: 新增短信应用、模板和签名接口。 2019-10-16 第九次正式发布。 本次变更如下:
您可以参考发送短信代码样例,进行快速上手调试。 接口类型 表1 接口类型说明 请求方法 POST 访问URI /sms/batchSendSms/v1 通信协议 HTTPS/HTTP 请求参数 表2 请求Headers参数 参数名称 是否必选 参数类型 默认值 说明 Content-Type 是 String 无 固
删除短信模板 功能介绍 该接口用于用户删除已创建的模板信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v2/{project_id}/msgsms/templates/{id}
发送分批短信 功能介绍 该接口用于向单个或多个手机号发送不同内容的短信。 前提条件 已创建短信应用,获取APP_Key、APP_Secret和APP接入地址。 (仅国内短信)已申请短信签名,获取签名通道号。 已申请短信模板,获取模板ID。 调试 您可以参考发送分批短信API,进行快速上手调试。
删除短信签名 功能介绍 该接口用于用户删除已创建的签名信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v2/{project_id}/msgsms/signatures/{id}
模板信息中,拆分条数为何显示为多条(>1)? 为何短信应用显示为暂停状态?如何恢复? 如何处理调用短信API超时? 调用短信API,出现SSL连接异常类报错,如何处理? 短信API测试过程中,因达到发送频率限制,测试手机号不能接收短信,该怎么办? 接口调用成功,但手机未收到短信是什么原因? 短信控制台访问异常如何处理?
签名审核驳回原因及处理建议是什么? 一级问题 二级问题 处理建议 材料或来源错误 提交资料与公众号/小程序、APP等主体不一致 检查是否填错了签名(错别字、同音字等)。 检查是否提交错材料,如本来需要提交A营业执照,结果上传时误选了B营业执照。 未查询到相关小程序或公众号 检查是否填错了签名(错别字、同音字等)。
认证 在计算机系统中,Token代表令牌(临时),拥有Token就代表拥有某种权限。Token认证就是调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 云服务存在两种部署方式:
调用API 认证鉴权 父主题: 发送接收短信
API使用说明 API列表 发送短信 接收状态报告 接收上行短信 发送短信API:向单个或多个用户发送相同内容的短信 发送分批短信API:向多个用户发送不同内容的短信 接收状态报告API:用于接收短信发送状态报告 接收上行短信API:用于接收用户回复的短信 API请求地址 API
如何调用API 构造请求 认证鉴权 返回结果 父主题: 应用、签名、模板
API 应用、签名、模板 发送接收短信
API概况 消息&短信服务所提供的接口,根据不同的API调用方式分为应用、签名、模板API和发送接收短信API。 表1 接口说明 类型 子类型 说明 应用、签名、模板API 短信应用API 可以实现查询短信应用、创建短信应用、查询应用数量、获取应用详情、修改短信应用等操作。 短信签名API
应用、签名、模板 如何调用API 获取调用信息 短信应用 短信签名 短信模板 父主题: API
认证鉴权 调用接口需通过特殊AK/SK认证或者X-WSSE认证。 推荐使用AK/SK签名认证方式,算法更安全。 特殊AK/SK认证(推荐) AK/SK签名认证方式仅支持12MB以内的消息体。 特殊AK/SK认证的“特殊”,是相对于一般AK/SK认证而言,AK、SK、EndPoin
获取终端节点 消息&短信终端节点如下表所示: 参数 描述 Endpoint Web 消息&短信当前可用Endpoint: 华北-北京四:msgsms.cn-north-4.myhuaweicloud.com 华南-广州:msgsms.cn-south-1.myhuaweicloud
短信应用 查询短信应用 创建短信应用 查询应用数量 获取应用详情 修改短信应用 父主题: 应用、签名、模板
获取调用信息 获取终端节点 获取账号、用户、项目的名称和ID 父主题: 应用、签名、模板
短信签名 查询签名信息 创建短信签名 获取签名详情 修改短信签名 删除短信签名 申请激活签名 查询申请文件 上传申请文件 父主题: 应用、签名、模板
在右上角的用户名中选择“我的凭证”。 图1 进入我的凭证 在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。 图2 查看账号名、账号ID、用户名、用户ID、项目名称、项目ID 调用API获取用户ID、项目ID 获取用户ID请参考:管理员查询IAM用户列表。