Bitzsoft.Integrations.LegalDatabase.Yuandian 1.0.1

Bitzsoft.Integrations.LegalDatabase.Yuandian

元典法规案例库集成 — 通过元典开放平台 REST API 实现法律法规 / 司法案例检索、文档获取与 SSO 跳转。

功能特性

• Token 鉴权 SSO：跳转链接携带 Token 参数，无需复杂签名
• REST API 检索：支持法律法规检索、案例文书检索，按 LegalSearchType 路由到不同接口
• 文档详情：按文档 ID 获取标准化法律文档
• MCP 协议：元典开放平台原生支持 MCP 协议接入
• 统一接口：实现 ILegalDatabaseProvider，与其他法律数据库供应商无缝替换

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.LegalDatabase.Yuandian

PackageReference

<PackageReference Include="Bitzsoft.Integrations.LegalDatabase.Yuandian" Version="1.0.0" />

配置

appsettings.json

{
  "LegalDatabase": {
    "Yuandian": {
      "BaseUrl": "https://open.chineselaw.com/",
      "ApiToken": "your-api-token"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.LegalDatabase.Yuandian;

builder.Services.AddBitzsoftYuandianLegalDatabase(
    builder.Configuration.GetSection("LegalDatabase:Yuandian"));

委托配置

builder.Services.AddBitzsoftYuandianLegalDatabase(options =>
{
    options.ApiToken = "your-api-token";
});

使用示例

生成 SSO 访问链接

using Bitzsoft.Integrations.LegalDatabase;

public class LoginController : ControllerBase
{
    private readonly ILegalDatabaseProvider _provider;

    public LoginController(ILegalDatabaseProvider provider) => _provider = provider;

    [HttpGet("login/yuandian")]
    public async Task<IActionResult> Login(string userId)
    {
        var access = await _provider.GenerateAccessUrlAsync(userId);
        // access.Url 形如: https://open.chineselaw.com/?token={token}
        return Redirect(access.Url);
    }
}

法律检索

using Bitzsoft.Integrations.LegalDatabase.Enums;

// 法规检索
var laws = await _provider.SearchAsync("民法典", LegalSearchType.Law, 1, 20);

// 案例文书检索
var cases = await _provider.SearchAsync("合同纠纷", LegalSearchType.Case, 1, 20);

Console.WriteLine($"共 {cases.TotalCount} 条");
foreach (var doc in cases.Items)
    Console.WriteLine($"{doc.Id}  {doc.Title}  ({doc.DocumentType})");

文档详情

var doc = await _provider.GetDocumentAsync("DOC-123456");
Console.WriteLine(doc.Title);
Console.WriteLine(doc.Summary);

请求审计

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，记录每次调用元典 API 的请求与响应，默认使用 NullRequestLogStore 不持久化。

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

// 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("ApiToken");
});
services.AddBitzsoftYuandianLegalDatabase(options => { /* ... */ });

依赖

相关包

• Bitzsoft.Integrations.LegalDatabase -- 法规案例库抽象层
• Bitzsoft.Integrations.LegalDatabase.All -- 全部 12 家供应商聚合包
• Bitzsoft.Integrations.SsoRedirect -- SSO 跳转配置驱动管道