Sms 短信域手册

Bitzsoft.Integrations.Sms/
├── ISMS.cs                         ← 抽象接口 + SMSResult
├── SmsMessage.cs                   ← 统一消息对象（胖 DTO）
├── SmsErrorCodes.cs                ← 内部错误码常量
├── ServiceCollectionExtensions.cs  ← 全部 6 家 DI 注册
├── Aliyun/  { AliyunSmsOptions, AliyunSmsService }
├── Tencent/ { TencentSmsOptions, TencentSmsService }
├── Huawei/  { HuaweiSmsOptions, HuaweiSmsService }
├── Yunpian/ { YunpianSmsOptions, YunpianSmsService }
├── Twilio/  { TwilioSmsOptions, TwilioSmsService }
└── Vonage/  { VonageSmsOptions, VonageSmsService }

public interface ISMS
{
    string ProviderName { get; }

    Task<SMSResult> SendAsync(
        SmsMessage message,
        CancellationToken cancellationToken = default);
}

public class SMSResult
{
    public bool Success { get; set; }
    public string? RequestId { get; set; }
    public string? BizId { get; set; }
    public string? ErrorCode { get; set; }
    public string? ErrorMessage { get; set; }

    public static SMSResult Ok(string? requestId = null, string? bizId = null);
    public static SMSResult Fail(string errorCode, string errorMessage);
    public static SMSResult FromException(Exception ex);
}

// 阿里云（使用 SDK 管道）
builder.Services.AddAliyunSms(builder.Configuration.GetSection("AliyunSms"));

// 腾讯云（使用 SDK 管道）
builder.Services.AddTencentSms(builder.Configuration.GetSection("TencentSms"));

// 华为云（使用 Typed HttpClient + WSSE 认证）
builder.Services.AddHuaweiSms(builder.Configuration.GetSection("HuaweiSms"));

// 云片
builder.Services.AddYunpianSms(builder.Configuration.GetSection("YunpianSms"));

// Twilio（国际短信）
builder.Services.AddTwilioSms(builder.Configuration.GetSection("TwilioSms"));

// Vonage（国际短信）
builder.Services.AddVonageSms(builder.Configuration.GetSection("VonageSms"));

public class NotificationService(ISMS sms)
{
    public async Task SendVerificationCodeAsync(string phone, string code)
    {
        var result = await sms.SendAsync(new SmsMessage
        {
            To = phone,
            SignName = "Bitzsoft",
            TemplateId = "SMS_123456789",
            TemplateParams = """{"code":"1234"}""",  // JSON 字符串
        });

        if (!result.Success)
            throw new InvalidOperationException(
                $"短信发送失败: {result.ErrorCode} - {result.ErrorMessage}");
    }
}

// 国际短信（Twilio）
public class InternationalSmsService(ISMS sms)
{
    public async Task SendAsync(string phone, string message)
    {
        var result = await sms.SendAsync(new SmsMessage
        {
            To = phone,           // E.164 格式，如 +12025550123
            Body = message,       // 纯文本
        });
    }
}

try
{
    // ... 发送逻辑
}
catch (OperationCanceledException)
{
    throw;  // 取消异常直接重抛，不被吞没
}
catch (Exception ex)
{
    return SMSResult.FromException(ex);
}

var handler = new MockHttpMessageHandler();
services.AddHttpClient<TwilioSmsService>()
    .ConfigurePrimaryHttpMessageHandler(() => handler);

var result = await sms.SendAsync(message);

Assert.True(result.Success);
Assert.NotNull(result.BizId);