组织机构2要素信息比对

更新时间:2022-03-10 15:44:22

接口描述

对企业、律所、非工商社会组织的组织机构名称,组织证件号(统一社会信用代码)一致性做核验

可查看更新日志了解详情。

接口

/v2/identity/verify/organization/enterprise/base

请求方式

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

组织机构证件号,支持15位工商注册号或统一社会信用代码

响应参数

展开全部参数参数名称

类型

必选

参数说明

code

int

接口响应结果码,该参数为0时表示接口调用成功

message

string

接口响应结果描述

data

object

接口响应结果数据

verifyId

string

信息比对业务Id,请注意保存该数值

请求示例  

{
    "name":"杭州xxx科技有限公司",
    "orgCode":"9133xxxxxxxxx6077"
}

响应示例

{
    "code": 0,   
    "message": "成功”,
    "data":{
        "verifyId": "2d3b07ee-7d5a-4981-8b82-b47af979d83c"
    }
  }

错误码

错误码

错误描述

解决方案

30500101

参数错误:企业名称长度不能小于2位字符

请核实企业名称是否为空或长度小于2

30500101

参数错误:企业证件号不能为空

请核实企业证件号是否为空

30500101

参数错误:请输入正确的组织机构证件号!

请核实企业证件号格式是否正确

30504001

信息比对不通过,请检查信息的正确性

信息比对不通过,请核实信息是否匹配

我要纠错