检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。
API使用说明 API列表 发送短信 接收状态报告 接收上行短信 发送短信API：向单个或多个用户发送相同内容的短信 发送分批短信API：向多个用户发送不同内容的短信 接收状态报告API：用于接收短信发送状态报告 接收上行短信API：用于接收用户回复的短信 API请求地址 API
认证鉴权 调用接口需通过特殊AK/SK认证或者X-WSSE认证。 推荐使用AK/SK签名认证方式，算法更安全。 特殊AK/SK认证（推荐） AK/SK签名认证方式仅支持12MB以内的消息体。 特殊AK/SK认证的“特殊”，是相对于一般AK/SK认证而言，AK、SK、EndPoin
调用API 认证鉴权 父主题： 发送接收短信
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用、签名、模板
man或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。获取Token后，您可以使用Token认证调用其他API。 父主题： 如何调用API
获取调用信息 获取终端节点 获取账号、用户、项目的名称和ID 父主题： 应用、签名、模板
获取终端节点 消息&短信终端节点如下表所示： 参数 描述 Endpoint Web 消息&短信当前可用Endpoint： 华北-北京四：msgsms.cn-north-4.myhuaweicloud.com 华南-广州：msgsms.cn-south-1.myhuaweicloud
API概况 消息&短信服务所提供的接口，根据不同的API调用方式分为应用、签名、模板API和发送接收短信API。 表1 接口说明 类型 子类型 说明 应用、签名、模板API 短信应用API 可以实现查询短信应用、创建短信应用、查询应用数量、获取应用详情、修改短信应用等操作。 短信签名API
API 应用、签名、模板 发送接收短信
推送AKSK验证 功能介绍 当开启推送AK/SK验证，并设置推送AK和SK后，平台将在HTTP推送状态报告时增加签名时间戳（X-Sdk-Date）和用于消息鉴权的哈希码（Authorization）。 注意事项 修改AK/SK后生效时间大约5分钟，期间可能会导致状态报告/上行短信
String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 响应参数 状态码： 200 表3 响应SmsSignatureResp参数 参数 是否必选 参数类型 描述 id 否 String 签名主键ID，用于获取、修改、删除、申请激活签名的唯一标识
图2 查看账号名、账号ID、用户名、用户ID、项目名称、项目ID 调用API获取用户ID、项目ID 获取用户ID请参考：管理员查询IAM用户列表。 获取项目ID请参考：查询指定条件下的项目列表。 父主题： 获取调用信息
获取应用详情 功能介绍 该接口用于用户查询应用详情信息。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{project_id}/msgsms/apps/{id}
Authorization格式错误 特殊AK/SK认证时，请检查HTTP消息头Authorization格式。 E000044 X-Sdk-Date过期 特殊AK/SK认证时，请检查HTTP消息头X-Sdk-Date的时间，不能与发送请求时的本地时间相差太大（15分钟内），否则会导致鉴权失败。 E000045
Invalid token Token无效。 请检查鉴权参数是否正确。 供参考的排查项： 调用接口的时候，如果使用的是token鉴权，则token需要使用project级的token，而不是Global级token。Project级的token，就是在到IAM申请token的时候，project参数需要填写。
体。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户Token接口，返回如图1所示的消息头，其中“x-subject-token”就是需要获取的用户Tok
获取模板详情 功能介绍 该接口用于用户查询已创建的模板详情。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{project_id}/msgsms/templates/{id}
X-Sdk-Date 否（特殊AK/SK认证必选） String 无 格式为：yyyyMMdd'T'HHmmss'Z' X-Sdk-Date不能与发送请求时的本地时间相差太大（15分钟内），否则会导致鉴权失败。 Host 否 String 无 API调用目的地址，用于特殊AK/SK认证：如smsapi
语言可参考表3。 X-Sdk-Date 否（特殊AK/SK认证必选） String 无 格式为：yyyyMMdd'T'HHmmss'Z' Host 否 String 无 API调用目的地址，用于特殊AK/SK认证：如 smsapi.cn-north-4.myhuaweicloud
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
