跳到主要内容

调用方式

请求结构

1. 服务地址

API 支持就近地域接入,根据调用接口时客户端所在的位置,会自动解析到最近的某个地域的服务器,短信服务默认的就近地域接入的域名为 api.sms.UMCloud.cn

USMS 短信服务使用如下域名作为服务地址接入:

接入地域域名备注
就近地域接入 1(推荐)api.sms.UMCloud.cn对延时敏感的业务,建议使用该域名
就近地域接入 2api.UMCloud.cn

2. 通信协议

UMCloud 云计算产品的所有 API 都支持通过 HTTP/HTTPS 进行通信,为了更好的确保通信的高安全性,推荐您使用 HTTPS 协议。

3. 请求方法

支持的 HTTP/HTTPS GET

4. 字符集编码

请求及返回结果都使用 UTF-8 字符集编码。

公共参数

公共参数是用于标识用户和接口签名的参数

为避免重复,下列公共参数不会再在各API文档中进行重复说明,但每次请求均需携带这些参数,否则无法正常发起请求

参数名必选参数类型说明
ActiontrueString对应的 API 名称,如 SendUSMSMessage
PublicKeytrueString对应的 API 公钥
SignaturetrueString根据 API 公私钥及 API 指令生成的用户签名,参见 签名算法
ProjectIdfalseString服务账号 ID,主账号与财务账号为空时为默认服务账号;子账号为必填字段,参见 获取 服务账号 ID