Bitzsoft.Integrations.LegalDatabase.Incopat 1.0.0-alpha.10

Bitzsoft.Integrations.LegalDatabase.Incopat

incoPat 专利数据库集成 — 支持 MD5 签名 SSO 跳转与专利 REST API 检索（专利检索、法律状态、权利要求）。

功能特性

• MD5 签名 SSO：签名规则 signature = MD5(UserName|timestamp|randomcode|AppSecretKey)
• 专利 REST API 检索：支持关键词检索、法律状态查询、权利要求获取
• 文档详情：按文档 ID 获取标准化专利文档
• 统一接口：实现 ILegalDatabaseProvider，与其他法律数据库供应商无缝替换

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.LegalDatabase.Incopat

PackageReference

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

配置

appsettings.json

{
  "LegalDatabase": {
    "Incopat": {
      "UserName": "your-sso-username",
      "AppSecretKey": "your-sso-secret-key",
      "SsoUrl": "https://www.incopat.com/sso",
      "ApiBaseUrl": "https://open.incopat.com/",
      "ApiToken": "your-rest-api-token"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.LegalDatabase.Incopat;

builder.Services.AddBitzsoftIncopatLegalDatabase(
    builder.Configuration.GetSection("LegalDatabase:Incopat"));

委托配置

builder.Services.AddBitzsoftIncopatLegalDatabase(options =>
{
    options.UserName = "your-sso-username";
    options.AppSecretKey = "your-sso-secret-key";
    // options.ApiToken = "your-rest-api-token";   // 如需专利检索
});

使用示例

生成 SSO 访问链接

using Bitzsoft.Integrations.LegalDatabase;

public class LoginController : ControllerBase
{
    private readonly ILegalDatabaseProvider _provider;

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

    [HttpGet("login/incopat")]
    public async Task<IActionResult> Login(string userId)
    {
        var access = await _provider.GenerateAccessUrlAsync(userId);
        // access.Url 形如: https://www.incopat.com/sso?username=...&signature=...&timestamp=...
        return Redirect(access.Url);
    }
}

incoPat SSO 使用配置中的统一用户名，userId 参数仅用于可选的 redirectUrl 拼接。

专利检索

using Bitzsoft.Integrations.LegalDatabase.Enums;

// 专利检索（全部类型）
var patents = await _provider.SearchAsync("半导体 芯片", LegalSearchType.All, 1, 20);

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

文档详情

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

请求审计

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

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

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

依赖

相关包

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