Bitzsoft.Integrations.EnterpriseMail.Feishu 1.0.0-alpha.9

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher.
This is a prerelease version of Bitzsoft.Integrations.EnterpriseMail.Feishu. 
dotnet add package Bitzsoft.Integrations.EnterpriseMail.Feishu --version 1.0.0-alpha.9
                    


                    

                
NuGet\Install-Package Bitzsoft.Integrations.EnterpriseMail.Feishu -Version 1.0.0-alpha.9
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Feishu" Version="1.0.0-alpha.9" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Bitzsoft.Integrations.EnterpriseMail.Feishu" Version="1.0.0-alpha.9" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Feishu" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Bitzsoft.Integrations.EnterpriseMail.Feishu --version 1.0.0-alpha.9
                    


                    

                
#r "nuget: Bitzsoft.Integrations.EnterpriseMail.Feishu, 1.0.0-alpha.9"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Bitzsoft.Integrations.EnterpriseMail.Feishu@1.0.0-alpha.9
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Bitzsoft.Integrations.EnterpriseMail.Feishu&version=1.0.0-alpha.9&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Bitzsoft.Integrations.EnterpriseMail.Feishu&version=1.0.0-alpha.9&prerelease
                    


                            Install as a Cake Tool

Bitzsoft.Integrations.EnterpriseMail.Feishu

飞书企业邮箱集成，基于飞书开放平台 API 实现 IEnterpriseMailProvider。

功能特性

  • 飞书开放平台 API，通过 App ID / App Secret 应用身份访问邮箱
  • 邮件操作：发送、列表、详情、搜索、删除、移动
  • 文件夹管理：列表、创建、删除
  • 附件管理：列表、下载
  • Page Token 分页（飞书 API 分页方式）

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseMail.Feishu

PackageReference

<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Feishu" Version="1.0.0" />

配置

{
  "Feishu": {
    "AppId": "cli_xxxxxxxx",
    "AppSecret": "xxxxxxxxxxxxxxxx",
    "DefaultUserMailboxId": "user@company.com"
  }
}
配置项 说明 默认值
AppId 飞书应用 ID —
AppSecret 飞书应用密钥 —
BaseUrl API 基地址 https://open.feishu.cn/open-apis
DefaultUserMailboxId 默认用户邮箱标识 —
HttpClientName 命名 HttpClient FeishuMail

注册服务

// 方式一：委托配置
services.AddBitzsoftFeishuMail(options =>
{
    options.AppId = "cli_xxxxxxxx";
    options.AppSecret = "xxxxxxxxxxxxxxxx";
    options.DefaultUserMailboxId = "user@company.com";
});

// 方式二：IConfiguration 绑定
services.AddBitzsoftFeishuMail(configuration, "Feishu");

第三方请求日志

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftFeishuMail(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxBodyLength = 8192;
    opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftFeishuMail(options => { /* ... */ });

使用示例

using Bitzsoft.Integrations.EnterpriseMail;
using Bitzsoft.Integrations.EnterpriseMail.Feishu;
using Bitzsoft.Integrations.EnterpriseMail.Models;

// 通过 DI 注入 IEnterpriseMailProvider
public class MailService
{
    private readonly IEnterpriseMailProvider _mail;

    public MailService(IEnterpriseMailProvider mail) => _mail = mail;

    public async Task SendAsync()
    {
        await _mail.SendAsync(new SendMailRequest
        {
            Subject = "通知",
            HtmlBody = "<p>测试邮件</p>",
            To = [new MailAddress { Address = "user@example.com" }],
        });
    }
}

核心类型一览

类型 说明
FeishuMailProvider 飞书邮箱服务实现（IEnterpriseMailProvider）
FeishuMailOptions 飞书邮箱配置选项

依赖

  • Bitzsoft.Integrations.EnterpriseMail，企业邮箱抽象层
  • Bitzsoft.Integrations.Compatibility，基础工具库
  • Microsoft.Extensions.Http，命名 HttpClient 工厂

注意事项

  • 分页使用 Page Token，获取第 N 页需线性遍历前面的页（飞书 API 限制）
  • 搜索 API 仅支持关键词，其他过滤条件通过客户端过滤实现
  • Provider 名称：Feishu

相关包

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Bitzsoft.Integrations.EnterpriseMail.Feishu:

Package Downloads
Bitzsoft.Integrations.EnterpriseMail.All

企业邮箱服务聚合包 — 包含所有供应商实现

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-alpha.9 54 7/12/2026
1.0.0-alpha.8 56 7/1/2026
1.0.0-alpha.7 70 6/16/2026
1.0.0-alpha.6 72 6/16/2026
1.0.0-alpha.5 61 6/14/2026
1.0.0-alpha.3 69 6/7/2026