查询个人签署账号（通过accountId查询）

更新时间：2022-02-28 15:50:42

接口描述

通过在【创建个人签署账号】接口返回的个人账号accounId，查询用户的账号信息。

API在线调试

可通过API在线调试工具使用接口功能，入口：查询个人账户

接口

/v1/accounts/{accountId}

请求方式

GET

请求头

提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。

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

请求头入参示例如下：

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	是	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值，Signature

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

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
X-Tsign-Open-Token	string	是	通过获取鉴权Token接口返回
Content-Type	string	是	application/json; charset=UTF-8

请求参数

参数名称		类型	必选	参数类型	参数说明
accountId		string	是	path	个人账号id

公共响应参数

参数名称	类型	必选	参数说明
code	int	是	业务码，0表示成功
message	string	否	信息
data	object	否	业务信息

响应参数

参数名称	类型	必选	参数说明
accountId	string	否	个人账号id
name	string	否	姓名
idType	string	否	证件类型，枚举类型如下：（1）CRED_PSN_CH_IDCARD 大陆身份证，默认值（2）CRED_PSN_CH_TWCARD 台湾来往大陆通行证（3）CRED_PSN_CH_MACAO 澳门来往大陆通行证（4）CRED_PSN_CH_HONGKONG 香港来往大陆通行证（5）CRED_PSN_PASSPORT 护照
idNumber	string	否	证件号
mobile	string	否	联系方式，手机号码
email	string	否	联系方式，邮箱地址
thirdPartyUserId	string	否	第三方平台的用户id

请求示例

GET https://smlopenapi.esign.cn/v1/accounts/1c04a729df94422ab8c8b664b5b1xxx

Postman请求示例

响应示例

{
    "code":0,
    "data":{
        "accountId":"1c04a729df94422ab8c8b664b5bxxxx",
        "idType":"CRED_PSN_CH_IDCARD",
        "thirdPartyUserId":"20190923194230111",
        "mobile":"182681xxxxx",
        "name":"**",
        "idNumber":"371302xxxxxxxx3728",
        "email":"xxx@tsign.com",
        "thirdPartyUserType":"_DEFAULT_USER",
        "status":false
    },
    "message":"成功"
}

错误码

错误码	错误描述	解决方案
53000000	账号已存在
53000001	账号不存在
53000002	账号类型不匹配