接口描述
对组织机构的名称、证件号和法人三要素进行一致性核验。
注：适用于工商体系企业、个体户、律所、非工商组织等
接口
/v2/identity/verify/organization/verify
请求方式
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 | 法定代表人姓名 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
code | int | 是 | 接口响应结果码，该参数为0时表示接口调用成功 | |
message | string | 是 | 接口响应结果描述 | |
data | object | 否 | 接口响应结果数据 | |
verifyId | string | 否 | 信息比对业务Id，请注意保存该数值（比对通过时返回，不一致不返回） | |
errCode | string | 否 | 子错误码，用于细分信息不一致的具体原因 | |
errMsg | string | 否 | 子错误信息详情，用于细分信息不一致的具体原因 | |
请求示例
{
"name": "杭州天谷****限公司",
"orgCode": "913301****306077",
"legalRepName": "金**"
}响应示例
信息比对结果一致：
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "dc6d7e03-06a6-****-84d1-b439cb950d15"
}
}信息比对结果不一致：
{
"code": 30504001,
"message": "信息比对不通过,请检查信息的正确性",
"data": {
"verifyId": null,
"errCode": "30504504",
"errMsg": "法人姓名不⼀致"
}
}错误码
展开全部参数错误码 | 错误描述 | 解决方案 | |
30500100 | 缺少参数：组织机构名称不能为空 | 请核实组织机构名称是否为空 | |
30500100 | 缺少参数：组织机构证件号不能为空 | 请核实组织机构证件号是否为空 | |
30500100 | 缺少参数：法定代表人姓名不能为空 | 请核实法定代表人姓名是否为空 | |
30500101 | 参数错误：请输入正确的组织机构证件号 | 请核实组织机构证件号格式是否正确 | |
30500101 | 参数错误：请输入正确长度的法定代表人姓名（2-100位） | 请输入正确的法定代表人姓名 | |
30504001（点击“+”展开详情） | 信息比对不通过,请检查信息的正确性 | 信息比对不通过，请核实信息是否匹配 | |
30504501 | 企业名称不⼀致 | 以企业证件号为标准，查询企业名称与企业工商信息不一致，请核实企业名称是否正确 | |
30504502 | 企业经营状态存在异常 | 请联系工商行政管理局更新企业状态后操作（一般是注销或者不在营业期限内） | |
30504504 | 法人姓名不⼀致 | 以企业证件号为标准，查询法定代表人/负责人姓名不一致，请核实法人姓名是否正确 | |
30504008 | 企业证件号与企业名称不匹配 | 企业证件号不存在，请核实企业证件号信息是否真实存在 | |
我要纠错