Skip to content
Bitzsoft.Integrationsbitzsoft.integrations

Reference

阿里企业邮箱

阿里企业邮箱包的 AlibabaMailOptions 配置字段、OAuth Client Credentials 鉴权与使用示例。

Last updated

包信息

属性
NuGet 包Bitzsoft.Integrations.EnterpriseMail.Alibaba
Provider IDalibaba
鉴权OAuth 2.0 Client Credentials(AppId + Secret)
生命周期Transient

配置字段(AlibabaMailOptions)

字段类型必填默认值说明
AppIdstring阿里邮箱 API 应用 AppId(Client ID)
Secretstring阿里邮箱 API 应用 Secret(Client Secret)
BaseUrlstringhttps://alimail-cn.aliyuncs.com阿里邮箱 API 基地址
DefaultUserEmailstring默认操作的邮箱地址
HttpClientNamestringAlibabaMail命名 HttpClient 名称

配置示例

{
"EnterpriseMail": {
"Alibaba": {
"AppId": "your-client-id",
"Secret": "your-client-secret",
"DefaultUserEmail": "user@your-domain.com"
}
}
}

DI 注册

// ① 配置节绑定
builder.Services.AddBitzsoftAlibabaMail(builder.Configuration.GetSection("EnterpriseMail:Alibaba"));
// ② 委托配置
builder.Services.AddBitzsoftAlibabaMail(options =>
{
options.AppId = "your-client-id";
options.Secret = "your-client-secret";
options.DefaultUserEmail = "user@your-domain.com";
});

使用示例

public class MailService(IEnterpriseMailProvider mail)
{
public async Task<SendMailResult> SendAsync(string to, string subject, string body)
{
return await mail.SendAsync(new SendMailRequest
{
To = new() { new MailAddress(to) },
Subject = subject,
Body = body,
});
}
public async Task<MailListResult> ListInboxAsync()
{
return await mail.ListMessagesAsync("INBOX", pageIndex: 1, pageSize: 20);
}
}

已知限制

  • 阿里邮箱 API 要求指定操作用户邮箱(DefaultUserEmail),不在请求中指定时使用配置默认值。
  • 部分高级搜索能力受限于阿里邮箱 API 的 SearchAsync 实现深度。

相关

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%