企业三要素验证API——构建高效且精准的企业信息验证环境

引言

企业三要素验证API是一种深度融合了大数据处理技术与权威数据源验证手段的企业身份核实服务应用程序接口。它旨在构建一个高效、精准的企业信息验证环境，以确保在商业交易、金融服务、供应链管理等多种场景下，能够迅速且准确地确认企业的真实身份与资质。

企业三要素（详版）验证API主要用于验证企业用户的真实身份和合法性,防止企业身份被盗用或假冒，降低消费者和企业商务合作中的风险。其中，企业的三要素是指企业名称、社会统一信用代码、核验人姓名（法人或者公司高管）。

接下来，我们来聊一聊怎么对接企业三要素（详版）验证API。

1.调用前的准备工作

API 查询需要两个核心信息，必须提前备好。

（1）获取API 接口权限

首先我们找到一家有企业三要素（详版）验证API的服务商，如数勋API，向提供 API 的服务商申请账号，购买免费套餐，申请通过后获取“API 密钥（AppKey）”和“密钥密码（AppSecret）”，调用时需通过这两个凭证完成身份认证，避免权限被盗用，务必保管好，不要泄露。

（2）明确查询参数

明确要查询的企业信息，如企业名称、统一社会信用代码、核验人姓名（法人或者公司高管）等，作为查询关键词。优先用统一社会信用代码（18 位），无重名风险，匹配准确率 100%；若没有，也可用企业全称（必须和工商登记一致）和法人代表或公司高管的姓名。

2.对接流程

以Java语言调用数勋API的企业三要素验证 API 为例，传入企业名称、社会统一信用代码、核验人姓名（法人或者公司高管），校验此三项是否一致，并返回人企关系信息。

示例代码：

package com.shuxun.data.impl.demo;

import com.shuxun.common.core.util.HttpUtil;
import org.apache.commons.codec.digest.DigestUtils;

import java.util.HashMap;
import java.util.Map;

public class Enterprise3CheckDemo {

    private static final String APP_KEY = "您的appKey";
    private static final String APP_SECRET = "您的appSecret";
    private static final String API_URL = "https://api.shuxuntech.com/v1/enterprise3/check";
    public static void main(String[] args) {
        String timestamp = System.currentTimeMillis()+"";
        String sign = DigestUtils.sha256Hex(APP_KEY + timestamp + APP_SECRET);

        Map<String, String> header = new HashMap<>(4);
        header.put("appKey", APP_KEY);
        header.put("timestamp", timestamp);
        header.put("sign", sign);

        Map<String, String> params = new HashMap<>(2);
        // 核验人姓名
        params.put("personName", "");
        // 企业名称
        params.put("entName", "");
        // 统一社会信用代码
        params.put("creditCode", "");

        // 工具类下载地址 https://file.shuxuntech.com/other/code/util.zip
        String result = HttpUtil.get(API_URL, header, params);
        System.out.println("返回结果="+result);
    }
}

完整流程如下：

（1）构造请求 URL

根据 API 文档说明，将 API 密钥、查询关键词等必要参数按照规定的格式构造请求 URL。

请求地址 url：https://api.shuxuntech.com/v1/enterprise3/check

参数：

签名算法说明：

数勋分配的appKey、当前unix时间毫秒数timestamp、数勋分配的appSecret、 按顺序拼接sha256加密得到sign，查看如下示例：

（2）发送请求

使用编程语言中的网络请求库，向构造好的 URL 发送 GET 或 POST 请求（具体请求方式根据 API 要求）。

请求方式 method：get/post

（3）解析返回数据

接收 API 返回的 JSON 或其他格式的数据，按照API文档说明解析数据，获取所需的人企关系信息。

返回示例如下：

正确返回：

错误返回：

返回字段描述：

data对象说明：

match对象说明：

code错误码说明：

结语

企业三要素验证API是一种深度融合了大数据处理技术与权威数据源验证手段的企业身份核实服务应用程序接口。它旨在构建一个高效、精准的企业信息验证环境，以确保在商业交易、金融服务、合作伙伴筛选等多种场景下，能够迅速且准确地确认企业的真实身份与资质。