接口描述
用于通过用户的组织机构名称查询其在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签宝页面完成了授权认证操作 |