Sms.md

Abp.Aliyun.Sms

一、基本配置

1.1 模块的引用

1.2 模块的配置

二、功能支持情况

2.1.1 发送短信

API	功能	是否支持
SendBatchSms	批量发送短信
SendSms	发送短信

2.1.2 查询发送记录

API	功能	是否支持
QuerySendDetails	查询短信发送状态

2.1.3 短信签名

API	功能	是否支持
AddSmsSign	申请短信签名
DeleteSmsSign	删除短信签名
ModifySmsSign	修改未审核的短信签名
QuerySmsSign	查询短信签名的审核状态

2.1.4 短信模板

API	功能	是否支持
AddSmsTemplate	申请短信模板
DeleteSmsTemplate	删除短信模板
ModifySmsTemplate	修改未审核的短信模板
QuerySmsTemplate	查询短信模板的审核状态

2.1.5 回执消息

关于阿里云的回执消息，本模块统一使用的是 HTTP API 的方式进行处理。当阿里云完成某项业务事件时，会调用模块提供的 API 接口通知开发人员业务结果。

API	功能	是否支持
SmsUp	上行短信消息回执
SmsReport	短信发送状态回执
SignSmsReport	短信签名审核回执
TemplateSmsReport	短信模板审核回执

三、功能的用法

3.1 基于 AliyunApiRequester 的直接调用

EasyAbp.Abp.Aliyun 所有的功能，都是基于 AliyunApiRequester 实现的，开发人员可以直接构造请求体(Request) 来操作所有接口。

下面就是一个发送短信功能的例子:

var request = new SendSmsRequest(AbpAliyunSmsTestsConsts.TargetPhoneNumber, 
    AbpAliyunSmsTestsConsts.CompanyName,
    AbpAliyunSmsTestsConsts.TemplateCode, 
    AbpAliyunSmsTestsConsts.TemplateParamJson);
            
var result = await AliyunApiRequester.SendRequestAsync<SmsCommonResponse>(request,
    AbpAliyunSmsOptions.EndPoint);

更多用法，请参考单元测试项目 EasyAbp.Abp.Aliyun.Sms.Tests。

3.2 基于单例服务的使用

本模块针对一些业务场景，提供了封装的单例服务类，便于开发人员使用。

TODO