Bitzsoft.Integrations.EnterpriseInfo.All 1.0.0

Bitzsoft.Integrations.EnterpriseInfo.All

企业信息查询全量聚合包，一键集成企查查、天眼查、启信宝三大供应商，总共 662 个 API 端点。

功能特性

• 按配置注册：AddBitzsoftEnterpriseInfo 只注册配置节中存在的供应商
• 稳定路由：通过 IIntegrationProviderResolver<IEnterpriseInfoProvider> 按 qichacha、tianyancha、qixin 解析
• 零配置负担：统一从 IConfiguration 读取各供应商配置节
• 抽象层可用：注册后可直接通过 IEnterpriseInfoProvider 注入，或按需注入具体供应商类型
• 按需选择：不想使用全部供应商时可独立安装各实现包

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseInfo.All

PackageReference

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

配置

appsettings.json

{
  "EnterpriseInfo": {
    "Qichacha": {
      "Key": "your-qichacha-key",
      "SecretKey": "your-qichacha-secret"
    },
    "Tianyancha": {
      "Token": "your-tianyancha-token"
    },
    "Qixin": {
      "AppKey": "your-qixin-appkey",
      "SecretKey": "your-qixin-secret"
    }
  }
}

每个供应商的配置节位于 EnterpriseInfo 下，与独立安装时的顶层配置节名称相同。若未配置某个供应商，其对应的注册将被跳过（不报错）。

注册服务

using Bitzsoft.Integrations.EnterpriseInfo.All;

// 一键注册全部三个供应商
services.AddBitzsoftEnterpriseInfo(configuration);

等价于手动依次调用：

services.AddBitzsoftQichachaEnterpriseInfo(configuration, "EnterpriseInfo:Qichacha");
services.AddBitzsoftTianyanchaEnterpriseInfo(configuration, "EnterpriseInfo:Tianyancha");
services.AddBitzsoftQixinEnterpriseInfo(configuration, "EnterpriseInfo:Qixin");

使用示例

using Bitzsoft.Integrations.EnterpriseInfo;
using Bitzsoft.Integrations.EnterpriseInfo.Models;

public class MultiSourceEnterpriseService(
    IIntegrationProviderResolver<IEnterpriseInfoProvider> providers)
{
    public IEnterpriseInfoProvider Resolve(string providerId)
        => providers.GetRequired(providerId);

    /// <summary>
    /// 从全部已注册供应商中查询企业信息，取首个非空结果
    /// </summary>
    public async Task<EnterpriseBasicInfo?> QueryFirstAvailableAsync(string creditCodeOrName)
    {
        foreach (var descriptor in providers.Providers)
        {
            var provider = providers.GetRequired(descriptor.ProviderId);
            try
            {
                var result = await provider.GetBasicInfoAsync(creditCodeOrName);
                if (result is not null && !string.IsNullOrEmpty(result.Name))
                    return result;
            }
            catch (EnterpriseInfoException ex)
            {
                Console.WriteLine($"{provider.ProviderName} 查询失败: {ex.Message}");
            }
        }
        return null;
    }

    /// <summary>
    /// 交叉核验：通过多个供应商同时验证企业信息
    /// </summary>
    public async Task<bool> CrossVerifyAsync(
        string creditCode, string name, string legalPerson)
    {
        var results = new List<bool>();
        foreach (var descriptor in providers.Providers)
        {
            var provider = providers.GetRequired(descriptor.ProviderId);
            try
            {
                var r = await provider.VerifyAsync(creditCode, name, legalPerson);
                results.Add(r.IsMatch);
            }
            catch (EnterpriseInfoException)
            {
                // 某个供应商调用失败，跳过
            }
        }
        // 所有成功响应的供应商均核验通过
        return results.Count > 0 && results.All(r => r);
    }
}

供应商对比

核心类型一览

依赖

• Bitzsoft.Integrations.EnterpriseInfo：抽象层
• Bitzsoft.Integrations.Compatibility：基础工具库
• Bitzsoft.Integrations.EnterpriseInfo.Qichacha：企查查实现
• Bitzsoft.Integrations.EnterpriseInfo.Tianyancha：天眼查实现
• Bitzsoft.Integrations.EnterpriseInfo.Qixin：启信宝实现

相关包

• Bitzsoft.Integrations.EnterpriseInfo：抽象层（独立安装时不包含任何供应商实现）
• Bitzsoft.Integrations.Compatibility：基础工具库