企业工商四要素验证API接口调用

2023-07-07

数脉API

企业工商四要素验证API接口调用

一、接口名称:

企业四要素验证

二、接口介绍:

企业四要素验证接口可以通过传入公司全称、统一社会信用代码、法人姓名及法人身份证号,验证是否一致,当一个企业能同时通过这四项验证的验证的时候,就能确认此企业具有一定的安全性与合法性,一般适用于各类有验证入驻企业身份、法人身份需求的互联网平台。

三、API接口文档

1、请求地址

https://api.shumaidata.com/v4/company-four/check

请求方式:get/post

参数

2、签名算法说明:

服务商分配的appid、当前时间毫秒数timestamp、服务商分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。


 如:appid=xyzxyzxyz,timestamp=1555378976238,app_security=efcefcefcefcefc ;

 拼接后的字符串:str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;

 加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;


3、正确返回:

{

   "msg": "成功",

   "success": true,

   "code": 200,

   "data": {

       "orderNo": "331698455182722374",

       "companyName": true,

       "creditNo": true,

       "legalPerson": true,

       "idCard": true

   }

}

4、错误返回:

{

   "msg": "参数错误",

   "success": false,

   "code": 400,

   "data": {}

}

5、返回字段说明:

6、code错误码说明

7、示例代码(以java为例)

 private static final String appId = "数脉分配给你的appid";

   private static final String appSecurity = "数脉分配给你的appsecurity";


   public static void main(String[] args){

       String timestamp = System.currentTimeMillis() + "";

       //参数

       String companyName = "公司名称";

       String creditNo = "统一社会信用代码";

       String legalPerson = "法人姓名";   

       String idCard = "身份证号";   


       //接口地址

       String url = "https://api.shumaidata.com/v4/company-four/check";

       //请下载MD5Utils文件,地址为 https://file.tianyandata.cn/demo/utils/MD5Utils.java

       String sign = MD5Utils.encrypt(appId+"&"+timestamp+"&"+appSecurity);

       System.out.println("sign: "+sign);


       Map<String,Object> params = new HashMap<String,Object>();

       params.put("appid",appId);

       params.put("timestamp",timestamp);

       params.put("sign",sign);

       params.put("companyName",companyName);

       params.put("creditNo",creditNo);

       params.put("legalPerson",legalPerson);

       params.put("idCard",idCard);         


       //请下载 HttpUtils文件,地址为 https://file.tianyandata.cn/demo/utils/HttpUtils.java

       String result = HttpUtils.get(url,null,params);

       System.out.println(result);

   }


》》》》》延伸接口推荐:企业三要素验证