企业三要素验证接口

包含两个版本接口:

  1. 企业三要素验证接口
  2. 企业三要素验证接口V3

1. 企业三要素验证接口


验证公司名,法人,统一信用代码,是否匹配。

请求方式

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

接口认证

客户每次调用接口,必需包含接入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 企业法人 雷军

响应结果

返回数据格式

所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {}
}

返回JSON属性如下:

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

响应示例

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {
        "code": 0,
        "desc": "一致"
    }
}

输出结果字段含义

 属性名 类型 含义
code Integer 代码
desc String 描述

代码说明表

代码 含义
0 一致
1 企业名称不一致
2 社会统一信用代码不一致
3 法人名称不一致
9 不一致

错误编码

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

2. 企业三要素验证接口V3


验证公司名,法人,统一信用代码,是否匹配,结果分别标识3要素是否匹配。

请求方式

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

接口认证

客户每次调用接口,必需包含接入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 企业法人 雷小军

响应结果

返回数据格式

所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {}
}

返回JSON属性如下:

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

响应示例

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

输出结果字段含义

 属性名 类型 含义
creditNo boolean 统一信用代码是否一致(true: 一致, false:不一致)
companyName boolean 公司名称是否一致(true: 一致, false:不一致)
legalPerson boolean 法人名称是否一致(true: 一致, false:不一致)

错误编码

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

results matching ""

    No results matching ""