API概览

本产品(短信服务/2017-05-25)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(78410016550),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

签名管理

API标题API概述
AddSmsSign申请短信签名一条完整的短信由短信签名和短信内容组成,发送短信前,您需要先申请签名和模板,系统会将已审核通过的短信签名添加到短信内容的开头,与短信内容一起发送给接收方。
QuerySmsSign查询签名审核状态申请签名后,通过此接口查询签名审核详情。
QuerySmsSignList查询签名列表详情可以通过此接口可以查询您账号下的所有签名,方便您查看签名详情,包括签名审核状态、签名类型、签名名称等。
ModifySmsSign修改短信签名修改未通过审核的签名,修改完成后自动提交审核,签名进入待审核状态。
DeleteSmsSign删除短信签名如果您不再使用某个短信签名,需要删除签名时,调用此接口或在短信服务控制台删除短信签名。
CreateSmsSign申请短信签名(新接口)短信签名作为短信发送方的一种标识,发送短信前,您需要先申请签名和模板,系统会将已审核通过的短信签名添加到短信内容的开头,并与短信内容一起发送给接收方。
UpdateSmsSign修改短信签名(新接口)修改未通过审核的签名,修改完成后自动提交审核,签名进入待审核状态。
GetSmsSign查询签名详情(新接口)申请签名后,通过此接口查询签名审核详情。

模板管理

API标题API概述
AddSmsTemplate申请短信模板短信模板即接收方收到短信的详细内容,包括变量和模板内容。您可以根据业务需要,申请验证码、通知短信或推广短信,模板审核通过后才可以发送短信。
QuerySmsTemplate查询模板审核状态查询单个短信模板的审核状态,返回是否通过审核及模板审核备注等信息。
QuerySmsTemplateList查询模板列表详情可以通过此接口查询您账号下的所有模板,方便您查看模板详情,包括模板审核状态、模板类型、模板内容等。
ModifySmsTemplate修改短信模板修改未通过审核的模板,调用本接口修改后将自动提交审核。
DeleteSmsTemplate删除短信模板如果您不再使用某个短信模板,需要删除模板时,调用此接口或在短信服务控制台删除短信模板。
CreateSmsTemplate申请短信模板(新接口)短信模板即接收方收到短信的详细内容,包括变量和模板内容。您可以根据业务需要,申请验证码、通知短信或推广短信,模板审核通过后才可以发送短信。
UpdateSmsTemplate修改短信模板(新接口)修改未通过审核的模板,调用本接口修改后将自动提交审核。
GetSmsTemplate查询模板审核详情(新接口)申请模板后,通过此接口查询模板审核详情,可查看模板审核状态。

短信发送

API标题API概述
SendSms发送短信向指定的手机号码发送短信。
SendBatchSms批量发送短信调用此接口可以给不同的手机号码,发送不同签名、同一个模板(可以是不同模板变量)的短信。

发送查询

API标题API概述
QuerySendDetails查询短信发送详情查询单个号码的短信发送记录和发送状态等信息。
QuerySendStatistics查询短信发送量统计查询短信发送统计详情,包括短信发送时间、短信发送成功条数、接收回执条数等。

卡片短信

API标题API概述
GetOSSInfoForCardTemplate获取OSS上传信息获取卡片短信所属OSS资源配置信息,此配置信息将用于后续OSS文件上传操作。
GetMediaResourceId获取媒体资源ID将用户上传到卡片短信OSS存储的图片、视频转换成(生成)资源数据统一管理,并返回资源ID,用户可以对返回的资源ID自行管理。
CreateCardSmsTemplate创建卡片短信模板创建卡片短信模板。
QueryCardSmsTemplate查询卡片短信模板状态查询卡片短信模板审核状态,返回手机厂商审核相关信息。
CheckMobilesCardSupport检查手机号是否支持卡片短信(旧接口)检查手机号码是否支持卡片短信。
QueryMobilesCardSupport查询手机号是否支持卡片短信(新接口)查询手机号是否支持卡片短信。
GetCardSmsLink获取卡片短信短链获取卡片短信短链。
GetCardSmsDetails查询单个号码的卡片短信发送记录和发送状态等信息查询单个号码的卡片短信发送记录和发送状态等信息。
QueryCardSmsTemplateReport查询卡片短信指定模板的解析数据查询卡片短信指定模板的解析数据,解析数据包括短信解析回执成功数、消息曝光次数和消息点击数等。
SendCardSms发送卡片短信发送卡片短信。
SendBatchCardSms批量发送卡片短信批量发送卡片短信。

获取OSS上传信息

API标题API概述
GetOSSInfoForUploadFile文本短信获取OSS上传信息获取OSS资源配置信息,此配置信息将用于后续OSS文件上传操作。

国内发国际短信转化率

API标题API概述
SmsConversionIntl国内发国际短信转化反馈将每一条消息ID(MessageId) 对应短信的接收情况反馈给阿里云国际短信平台。
ConversionDataIntl国内发国际转化率数据接入API将短信转化率统计数据反馈给阿里云短信平台。

标签管理

API标题API概述
ListTagResources查询模板标签标签是您为模板添加的标记,每个标签都由一对键值对(Key-Value)组成。您可以查询标签键值对绑定的模板Code,也可以查询某个模板已绑定的所有标签。
TagResources添加模板标签标签可以标记资源,允许企业或个人将同类型的模板进行资源归类,便于搜索和资源聚合。调用本接口对短信模板进行标签绑定。
UntagResources删除模板标签标签可以标记资源,允许企业或个人将同类型的模板进行资源归类,便于搜索和资源聚合。如果模板不再适用于当前已绑定的标签,可以从模板中解绑标签。您可以删除单个标签,也可以批量删除标签。