Bitzsoft.Integrations.EnterpriseInfo.Tianyancha 1.0.1

Bitzsoft.Integrations.EnterpriseInfo.Tianyancha

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

功能特性

• 完整实现 IEnterpriseInfoProvider 接口：覆盖搜索、工商基本信息、详情、核验、风险、股东、司法案件、实际控制人全部 8 个核心方法
• 225 个 API 端点：按业务领域分 10 个部分类文件组织，涵盖工商信息、法律、经营、风险、知识产权、历史、人员、股权、发展、增值服务
• Token 鉴权：通过 Authorization: {token} Header 传递认证令牌
• IHttpClientFactory 集成：通过 Microsoft.Extensions.Http 管理 HTTP 连接
• 配置提供器模式：通过 ITianyanchaConfigProvider 抽象配置获取
• 部分类架构：主 Provider + 10 个按业务领域拆分的部分类文件

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseInfo.Tianyancha

PackageReference

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

配置

appsettings.json

{
  "Tianyancha": {
    "Token": "your-api-token",
    "BaseUrl": "http://open.api.tianyancha.com",
    "HttpClientName": "Tianyancha"
  }
}

注册服务

使用委托配置（推荐）

using Bitzsoft.Integrations.EnterpriseInfo.Tianyancha;

services.AddBitzsoftTianyanchaEnterpriseInfo(options =>
{
    options.Token = "your-api-token";
});

从 IConfiguration 绑定

using Bitzsoft.Integrations.EnterpriseInfo.Tianyancha;

services.AddBitzsoftTianyanchaEnterpriseInfo(configuration, "Tianyancha");

第三方请求日志

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

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

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

使用示例

using Bitzsoft.Integrations.EnterpriseInfo;
using Bitzsoft.Integrations.EnterpriseInfo.Tianyancha;

public class TianyanchaEnterpriseService
{
    private readonly TianyanchaEnterpriseInfoProvider _provider;

    public TianyanchaEnterpriseService(TianyanchaEnterpriseInfoProvider provider)
    {
        _provider = provider;
    }

    public async Task DemoAsync()
    {
        // 模糊搜索企业
        var searchResult = await _provider.SearchAsync("阿里巴巴");

        // 获取企业详情（含股东、主要人员、变更记录）
        var detail = await _provider.GetDetailInfoAsync("阿里巴巴（中国）有限公司");

        // 查询司法案件
        var cases = await _provider.GetLegalCasesAsync("阿里巴巴（中国）有限公司");

        // 调用天眼查特有 API（非接口方法，返回原始 JSON）
        var result = await _provider.GetBasicInfoNormalAsync("阿里巴巴");
        var data = result.Data; // JsonElement，按需解析
    }
}

核心类型一览

依赖

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

相关包

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