Bitzsoft.Integrations.EnterpriseInfo.Qichacha 1.0.1

Bitzsoft.Integrations.EnterpriseInfo.Qichacha

企查查企业信息查询实现，从 Qichacha 开放平台获取工商、司法、经营等企业全维度数据。

功能特性

• 完整实现 IEnterpriseInfoProvider 接口：覆盖搜索、工商基本信息、详情、核验、风险、股东、司法案件、实际控制人全部 8 个核心方法
• 167 个 API 端点：按业务领域分 11 个部分类文件组织，涵盖工商信息、法律诉讼、风险、经营、发展、知识产权、历史、增值服务等
• MD5 动态签名：内置 MD5(Key + Timespan + SecretKey).toUpperCase() 鉴权机制
• IHttpClientFactory 集成：通过 Microsoft.Extensions.Http 管理 HTTP 连接
• 配置提供器模式：通过 IQichachaConfigProvider 抽象配置获取，支持静态配置或动态配置中心
• 部分类架构：主 Provider + 10 个按业务领域拆分的部分类文件，每个文件 200-400 行

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseInfo.Qichacha

PackageReference

<PackageReference Include="Bitzsoft.Integrations.EnterpriseInfo.Qichacha" Version="1.0.0" />

配置

appsettings.json

{
  "Qichacha": {
    "Key": "your-app-key",
    "SecretKey": "your-secret-key",
    "BaseUrl": "https://api.qichacha.com/",
    "HttpClientName": "Qichacha"
  }
}

注册服务

使用委托配置（推荐）

using Bitzsoft.Integrations.EnterpriseInfo.Qichacha;

services.AddBitzsoftQichachaEnterpriseInfo(options =>
{
    options.Key = "your-app-key";
    options.SecretKey = "your-secret-key";
    options.BaseUrl = "https://api.qichacha.com/";
});

从 IConfiguration 绑定

using Bitzsoft.Integrations.EnterpriseInfo.Qichacha;

services.AddBitzsoftQichachaEnterpriseInfo(configuration, "Qichacha");

第三方请求日志

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

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

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

使用示例

using Bitzsoft.Integrations.EnterpriseInfo;
using Bitzsoft.Integrations.EnterpriseInfo.Qichacha;

public class QichachaEnterpriseService
{
    private readonly QichachaEnterpriseInfoProvider _provider;

    public QichachaEnterpriseService(QichachaEnterpriseInfoProvider provider)
    {
        _provider = provider;
    }

    public async Task DemoAsync()
    {
        // 模糊搜索企业
        var searchResult = await _provider.SearchAsync("小米科技");

        // 获取工商照面
        var basicInfo = await _provider.GetBasicInfoAsync("小米科技有限责任公司");

        // 查询风险信息
        var riskSummary = await _provider.GetRiskSummaryAsync("小米科技有限责任公司");

        // 调用企查查特有 API（非接口方法，返回原始 JSON）
        var result = await _provider.GetDishonestListAsync("小米科技有限责任公司");
        var data = result.Data; // JsonElement，按需解析
    }
}

核心类型一览

依赖

• Bitzsoft.Integrations.EnterpriseInfo：企业信息查询抽象层
• Bitzsoft.Integrations.Compatibility：基础工具库
• Microsoft.Extensions.Http：HttpClient 工厂支持

相关包

• Bitzsoft.Integrations.EnterpriseInfo：抽象层
• Bitzsoft.Integrations.Compatibility：基础工具库
• Bitzsoft.Integrations.EnterpriseInfo.Tianyancha：天眼查实现
• Bitzsoft.Integrations.EnterpriseInfo.Qixin：启信宝实现
• Bitzsoft.Integrations.EnterpriseInfo.All：全部供应商聚合包