查询个人授权认证信息

更新时间：2022-04-01 10:03:43

接口描述

用于通过用户的手机号或邮箱查询其已授权的e签宝SaaS官网个人账号基本信息。

注意：

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

接口

/v2/open/accounts/authorizerInfo

请求方式

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鉴权方式，请点击查看具体请求头。

请求参数

参数名称	类型	必选	参数类型	参数说明
mobile	string	否	body	用户在e签宝SaaS官网的登录手机号注意：账号ID、手机号和邮箱至少选择一个传值。如果账号ID、手机号和邮箱都传值，查询实名状态的优先级是：账号ID > 手机号 > 邮箱
email	string	否	body	用户在e签宝SaaS官网的登录邮箱
accountId	string	否	body	e签宝SaaS官网个人账号ID，允许为空

响应参数

展开全部参数参数名称		类型	必选	参数说明
code		int	是	业务码，0表示成功
message		string	是	业务信息
data		object	否	业务数据
	accountId	string	否	e签宝SaaS官网个人账号ID
	mobile	string	否	用户在e签宝SaaS官网的登录手机号
	email	string	否	用户在e签宝SaaS官网的登录邮箱
	certNo	string	否	用户在e签宝SaaS官网已认证的个人证件号
	name	string	否	用户在e签宝SaaS官网已认证的个人姓名
	certType	string	否	用户在e签宝SaaS官网已认证的个人证件类型【中国大陆居民身份证】 CRED_PSN_CH_IDCARD 【香港来往大陆通行证】 CRED_PSN_CH_HONGKONG 【澳门来往大陆通行证】 CRED_PSN_CH_MACAO 【台湾来往大陆通行证】 CRED_PSN_CH_TWCARD 【护照】 CRED_PSN_PASSPORT
	bankCardNo	string	否	用户在e签宝SaaS官网已认证的个人银行卡号（只有用银行卡四要素认证时才会返回）
	realNameMobile	string	否	用户在e签宝SaaS官网已认证的个人手机号（只有用银行卡四要素及运营商三要素认证时才会返回）
	psnSmFlowId	string	否	个人实名认证流程ID

请求示例

{
    "accountId": "xxx", 
    "mobile": "138xxxx2222",                   
    "email": "xxx@esign.cn"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "accountId": "xxx",
        "mobile": "138xxxx2222",
        "email": null,
        "certNo": "11010119960312xxx",
        "name": "**",
        "certType": "CRED_PSN_CH_IDCARD",
        "bankCardNo": "6000121103016089253",
        "realNameMobile": "153xxxx0000",
        "psnSmFlowId": "21884492xxx4945185"
    }
}

错误码

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