接口描述
用于通过用户的手机号或邮箱查询其已授权的e签宝SaaS官网个人账号基本信息。
注意:
该接口仅在【获取认证链接】接口中使用授权认证模式(bizType传参:combination)时才能成功查询到用户授权信息。
接口地址&请求方式
接口地址:/v2/open/accounts/authorizerInfo
请求方式:POST
请求头格式
具体请求头格式结构,请点击查看公共参数说明。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 | |
mobile | string | 否 | body | 用户在e签宝SaaS官网的登录手机号 注意:账号ID、手机号和邮箱至少选择一个传值。 如果账号ID、手机号和邮箱都传值,查询实名状态的优先级是:账号ID > 手机号 > 邮箱 | |
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官网的登录手机号 | |
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" }
响应示例
{ "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签宝页面完成了授权认证操作 |