查询个人实名状态

更新时间：2021-11-22 12:16:08

接口描述

用于通过用户的手机号或邮箱查询其在e签宝SaaS官网的个人实名状态。

接口

/v2/open/accounts/realNameInfo

请求方式

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

个人用户手机号

注意：手机号和邮箱至少选择一个传值。

如果手机号和邮箱都传值，查询实名状态的优先级是：手机号 > 邮箱。

string

否

body

个人用户邮箱

响应参数

展开全部参数参数名称		类型	必选	参数说明
code		int	是	业务码，0表示成功
message		string	是	信息
data		object	否	业务信息
	mobile	string	否	用户在e签宝SaaS官网的登录手机号
	email	string	否	用户在e签宝SaaS官网的登录邮箱
	realNameStatus	boolean	否	e签宝SaaS官网账号对应个人实名状态 true：已实名 false：未实名
	accountId	string	否	e签宝SaaS官网个人账号ID

请求示例

{
    "mobile": "13811112xxx",
    "email": "xxx@esign.cn"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "accountId": "f06d94be6ced4a95bf15e4c5ea5dxxx",
        "mobile": "13811112xxx",
        "email": null,
        "realNameStatus": true
    }
}

错误码

错误码	错误描述	解决方案
1560002	账号不存在	请核实入参的手机号/邮箱是否发起过认证