调用方式
请求结构
1. 服务地址
API 支持就近地域接入,根据调用接口时客户端所在的位置,会自动解析到最近的某个地域的服务器,短信服务默认的就近地域接入的域名为 api.sms.UMCloud.cn
USMS 短信服务使用如下域名作为服务地址接入:
接入地域 | 域名 | 备注 |
---|---|---|
就近地域接入 1(推荐) | api.sms.UMCloud.cn | 对延时敏感的业务,建议使用该域名 |
就近地域接入 2 | api.UMCloud.cn |
2. 通信协议
UMCloud 云计算产品的所有 API 都支持通过 HTTP/HTTPS 进行通信,为了更好的确保通信的高安全性,推荐您使用 HTTPS 协议。
3. 请求方法
支持的 HTTP/HTTPS GET
4. 字符集编码
请求及返回结果都使用 UTF-8 字符集编码。
公共参数
公共参数是用于标识用户和接口签名的参数
为避免重复,下列公共参数不会再在各API文档中进行重复说明,但每次请求均需携带这些参数,否则无法正常发起请求
。
参数名 | 必选 | 参数类型 | 说明 |
---|---|---|---|
Action | true | String | 对应的 API 名称,如 SendUSMSMessage |
PublicKey | true | String | 对应的 API 公钥 |
Signature | true | String | 根据 API 公私钥及 API 指令生成的用户签名,参见 签名算法 |
ProjectId | false | String | 服务账号 ID,主账号与财务账号为空时为默认服务账号;子账号为必填字段,参见 获取 服务账号 ID |