接口描述
对工商体系中的企业名称、证件号和法定代表人信息的一致性进行检查校验
接口
/v2/identity/verify/organization/enterprise/bureau4Factors
请求方式
POST
请求头
提供两种安全接入方式，对应参数如何获取，参考文档【请点击】。
方式一：请求签名鉴权（优先推荐）
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-App-Id | string | 是 | 应用ID |
Content-Type | string | 是 | application/json;charset=UTF-8 |
X-Tsign-Open-Ca-Timestamp | string | 是 | API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击 |
Accept | string | 是 | 建议统一填写 */* |
X-Tsign-Open-Ca-Signature | string | 是 | 签名字符串 |
Content-MD5 | string | 是 | 当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。 |
X-Tsign-Open-Auth-Mode | string | 是 | 选择请求方式进行鉴权，固定值，Signature |
方式二：OAuth2.0鉴权（不推荐使用）
当安全接入选择OAuth2.0鉴权方式，请点击查阅详情。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 |
name | string | 是 | body | 企业名称 |
orgCode | string | 是 | body | 企业统一社会信用代码或工商注册号 |
legalRepName | string | 是 | body | 企业法定代表人姓名 |
legalRepCertNo | string | 是 | body | 企业法定代表人证件号 注：法人证件号支持中国大陆身份证，台湾来往大陆通行证，港澳来往大陆通行证，护照这几种证件类型。但接口不做法人证件号格式校验。 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
code | int | 是 | 接口响应结果码，该参数为0时表示接口调用成功 | |
message | string | 是 | 接口响应结果描述 | |
data | object | 否 | 接口响应结果数据 | |
verifyId | string | 否 | 信息比对业务Id，请注意保存该数值（比对通过时返回，不一致不返回） | |
errCode | string | 否 | 子错误码，用于细分信息不一致的具体原因 | |
errMsg | string | 否 | 子错误信息详情，用于细分信息不一致的具体原因 | |
请求示例
{
"name":"杭州xxx科技有限公司",
"orgCode":"9133xxxxxxxx306077",
"legalRepName":"何**",
"legalRepCertNo":"110108XXXXXXX2XXX"
}响应示例
信息比对结果一致：
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "1f7a67ce-c108-1111-91d9-4909051c2e8f",
"errCode": null,
"errMsg": null
}
}信息比对结果不一致：
{
"code": 30504001,
"message": "信息比对不通过,请检查信息的正确性",
"data": {
"verifyId": null,
"errCode": "30504501",
"errMsg": "企业名称不⼀致"
}
}错误码
展开全部参数错误码 | 错误描述 | 解决方案 | |
30500100 | 缺少参数：企业名称不能为空 | 请核实企业名称是否正确传入 | |
30500100 | 缺少参数：企业证件号不能为空 | 请核实企业证件号是否正确传入 | |
30500100 | 缺少参数：法定代表人姓名不能为空 | 请核实法定代表人姓名是否正确传入 | |
30500100 | 缺少参数：法定代表人证件号不能为空 | 请核实法定代表人证件号是否正确传入 | |
30500101 | 参数错误：请输入正确的组织机构证件号 | 请核实企业证件号格式是否正确 | |
30500101 | 参数错误：请输入正确长度的法定代表人姓名（2-100位） | 请输入正确的法定代表人姓名 | |
30504001（点击“+”展开详情） | 信息比对不通过,请检查信息的正确性 | 信息比对不通过，请核实信息是否匹配 | |
30504501 | 企业名称不⼀致 | 以企业证件号为标准，查询企业名称与企业工商信息不一致，请核实企业名称是否正确 | |
30504502 | 企业经营状态存在异常 | 请联系工商行政管理局更新企业状态后操作（一般是注销或者不在营业期限内） | |
30504504 | 法人姓名不⼀致 | 以企业证件号为标准，查询法定代表人/负责人姓名不一致，请核实法人姓名是否正确 | |
30504507 | 法人证件号不⼀致 | 以企业证件号为标准，查询法定代表人/负责人证件号不一致，请核实法人证件号是否正确 | |
30504508 | 企业证件号与企业名称不匹配 | 企业证件号不存在，请核实企业证件号信息是否真实存在 | |
我要纠错