企业4要素验证接口

验证公司名，统一信用代码，法人，法人证件号是否匹配

请求方式

请求地址: http://api.shuidi.cn/open/ic/4e/verify
请求方式: GET/POST
支持格式: JSON
请求示例: http://api.shuidi.cn/open/ic/4e/verify?pname=patest&ptime=1571990576623&vkey=2237ae09ea514c43a37ab0c57968f536&companyName=小米科技有限责任公司&creditNo=91110108551385082Q&legalPerson=雷军&idCard=31010719xxxxxxxx

接口认证

客户每次调用接口，必需包含接入ID(pname), 安全验证码(vkey)和时间戳(ptime).

参数名称	类型	是否必填	说明	示例值
pname	String	是	调用方唯一ID，用于身份识别	patest
ptime	String	是	时间戳,从格林威治时间1970年01月01日00时00分00秒起至现在的时间，精确到毫秒(13位)	1571990576623
vkey	String	是	安全验证码。使用下划线依次连接pkey、ptime、pkey，计算该字符串的MD5值完成签名. 结果为32个字符	2237ae09ea514c43a37ab0c57968f536

Java计算vkey示例：

String ptime =String.valueOf(System.currentTimeMillis());
SecureUtil.md5(pkey + "_" + ptime + "_" + pkey);

php计算vkey示例：

$vkey=md5($pkey.”_”.$ptime.”_”.$pkey)

请求参数

参数名称	类型	是否必填	说明	示例
companyName	String	是	公司名	小米科技有限责任公司
creditNo	String	是	社会统一信用代码	91110108551385082Q
legalPerson	String	是	企业法人	雷军
idCard	String	是	企业法人证件号	31010719xxxxxxxx

响应结果

返回数据格式

所有接口返回值以JSON字符串的形式返回给调用者，JSON格式如下：
{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {}
}
返回JSON属性如下:

属性	说明
statusCode	返回查询结果编码
statusMessage	statusCode不为1时的错误信息描述。
data	结果数据。不同接口，data的内容会有所不同。具体见各接口返回说明。

响应示例

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {
        "creditNo": true,
        "companyName": true,
        "idCard": false,
        "legalPerson": true
    }
}

输出结果字段含义

属性名	类型	含义
creditNo	boolean	统一信用代码是否一致
companyName	boolean	公司名称是否一致
idCard	boolean	法人证件号是否一致
legalPerson	boolean	法人名称是否一致

错误编码

错误编码	说明
1	请求成功
2	未查询到数据
3	接口未授权
4	请求参数错误
30001	请求已过期
99999	系统错误

results matching ""

No results matching ""