查询组织机构授权认证信息

更新时间：2022-04-01 10:08:54

接口描述

用于通过用户的组织机构名称查询其在e签宝SaaS官网的机构实名状态。

用于通过用户的组织机构名称查询其已授权的e签宝SaaS官网机构账号基本信息。

注意：

该接口仅在【获取认证链接】接口中使用授权认证模式（bizType传参：combination）时才能成功查询到用户授权信息。

名词解释：组织机构是企业、事业单位、机关、社会团体及其他依法成立单位的统称。

接口

/v2/open/organizations/authorizingPartyInfo

请求方式

POST

请求头

方式一：请求签名鉴权（优先推荐）

当接口调用选择请求签名鉴权方式，点击查看详细说明。

参数名称	类型	必选	参数说明
X-Tsign-Open-Auth-Mode	string	是	接口鉴权方式，请填写固定值Signature
X-Tsign-Open-App-Id	string	是	应用ID
X-Tsign-Open-Ca-Signature	string	是	请求签名值，查看请求签名值计算说明。
X-Tsign-Open-Ca-Timestamp	string	是	接口调用时的Unix时间戳，单位毫秒。防重放攻击，时间戳有效期为15分钟。
Content-MD5	string	否	当请求Body体为非Form格式时，需要对Body体计算ContentMD5并传给网关进行校验。 application/json格式的Body体时此项必选。
Content-Type	string	是	application/json; charset=UTF-8
Accept	string	是	建议统一填写 /

方式二：OAuth2.0鉴权（不推荐使用）

当接口调用选择OAuth2.0鉴权方式，请点击查看具体请求头。

请求参数

参数名称

类型

必选

参数类型

参数说明

name

string

否

body

用户在e签宝SaaS官网的组织机构名称

注意：账号ID和组织机构名称至少选择一个传值。

如果账号ID和组织机构名称都传值，查询实名状态的优先级是：账号ID > 组织机构名称

orgId

string

否

body

e签宝SaaS官网机构账号ID，允许为空

响应参数

展开全部参数参数名称		类型	必选	参数说明
code		int	是	业务码，0表示成功
message		string	是	业务信息
data		object	否	业务数据
	orgId	string	否	e签宝SaaS官网机构账号ID
	name	string	否	用户在e签宝SaaS官网已认证的组织机构名称
	legalRepName	string	否	用户在e签宝SaaS官网已认证的组织机构法定代表人姓名
	certNo	string	否	用于在e签宝SaaS官网已认证的组织机构证件号
	certType	string	否	用户在e签宝SaaS官网已认证的组织机构证件类型【统一社会信用代码】 CRED_ORG_USCC 【工商注册号】 CRED_ORG_REGCODE
	legalRepCertNo	string	否	用户在e签宝SaaS官网已认证的组织机构法定代表人证件号
	legalRepCertType	string	否	用户在e签宝SaaS官网已认证的组织机构法定代表人证件类型：【中国大陆居民身份证】 CRED_PSN_CH_IDCARD 【台湾来往大陆通行证】 CRED_PSN_CH_TWCARD 【澳门来往大陆通行证】 CRED_PSN_CH_MACAO 【香港来往大陆通行证】 CRED_PSN_CH_HONGKONG 【护照】 CRED_PSN_PASSPORT
	orgSmFlowId	string	否	企业实名认证流程ID

请求示例

{
    "orgId": "",
    "name": "xxx测试企业"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "orgId": "ede017f6001e4474a355bb3dfxxx",
        "name": "xxx测试企业",
        "legalRepName": "张三",
        "certNo": "911112200000000001",
        "certType": "CRED_ORG_USCC",
        "legalRepCertNo": "11010119960312xxx",
        "legalRepCertType": "CRED_PSN_CH_IDCARD",
        "orgSmFlowId": "20651956xxx9866124"
    }
}

错误码

错误码	错误描述	解决方案
1560002	账号不存在	请核实入参的手机号/邮箱是否发起过认证
1563047	用户未授权，无法查询该用户实名信息	请确认给用户发起过授权认证，且用户在e签宝页面完成了授权认证操作