Bitzsoft.Integrations.EnterpriseInfo.Qixin 1.0.1

Bitzsoft.Integrations.EnterpriseInfo.Qixin

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

功能特性

• 完整实现 IEnterpriseInfoProvider 接口：覆盖搜索、工商基本信息、详情、核验、风险、股东、司法案件、实际控制人全部 8 个核心方法
• 270 个 API 端点：来自启信开放平台官方目录（https://data.qixin.com/api-list），覆盖全部 18 个业务分类
• MD5 动态签名：内置 MD5(appkey + timestamp + secret_key).toLowerCase() 鉴权机制，通过 Auth-Version: 2.0 Header 传递
• IHttpClientFactory 集成：通过 Microsoft.Extensions.Http 管理 HTTP 连接
• 配置提供器模式：通过 IQixinConfigProvider 抽象配置获取
• 部分类架构：主 Provider + 4 个按业务领域拆分的部分类文件

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseInfo.Qixin

PackageReference

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

配置

appsettings.json

{
  "Qixin": {
    "AppKey": "your-app-key",
    "SecretKey": "your-secret-key",
    "BaseUrl": "https://api.qixin.com/APIService",
    "HttpClientName": "Qixin"
  }
}

注册服务

使用委托配置（推荐）

using Bitzsoft.Integrations.EnterpriseInfo.Qixin;

services.AddBitzsoftQixinEnterpriseInfo(options =>
{
    options.AppKey = "your-app-key";
    options.SecretKey = "your-secret-key";
});

从 IConfiguration 绑定

using Bitzsoft.Integrations.EnterpriseInfo.Qixin;

services.AddBitzsoftQixinEnterpriseInfo(configuration, "Qixin");

第三方请求日志

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

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

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

使用示例

using Bitzsoft.Integrations.EnterpriseInfo;
using Bitzsoft.Integrations.EnterpriseInfo.Qixin;

public class QixinEnterpriseService
{
    private readonly QixinEnterpriseInfoProvider _provider;

    public QixinEnterpriseService(QixinEnterpriseInfoProvider provider)
    {
        _provider = provider;
    }

    public async Task DemoAsync()
    {
        // 企业高级搜索
        var searchResult = await _provider.SearchAsync("腾讯科技");

        // 获取工商照面
        var basicInfo = await _provider.GetBasicInfoAsync("腾讯科技（深圳）有限公司");

        // 三要素核验
        var verify = await _provider.VerifyAsync(
            "9144030071526726XG",
            "腾讯科技（深圳）有限公司",
            "马化腾");

        // 调用启信宝特有 API（非接口方法，返回原始 JSON）
        var result = await _provider.QueryBasicInfoAsync("腾讯科技");
        var data = result.Data; // JsonElement，按需解析

        // 获取启信分
        var score = await _provider.GetCreditScoreAsync("腾讯科技（深圳）有限公司");

        // 获取客户信息尽调（KYC）
        var kyc = await _provider.GetAllEntInfoByNameAsync("腾讯科技（深圳）有限公司");
    }
}

API 覆盖范围

核心类型一览

依赖

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

相关包

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