调用该接口通过三方外标查询账号信息。
路径 | /cloud/account/getByOpenId |
版本号 | 1.0.4 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 否 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
openId | String | 是 | 三方账号外标。 | |
openIdAppKey | String | 是 | 开放平台AppKey。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
message | String |
调用失败时,返回的出错信息。 |
|
localizedMsg | String |
本地语言的错误消息。 |
|
data | String |
响应结果。 |
|
identityId | String |
账号的身份ID。 |
|
loginId | String |
账号的登录ID。 |
|
loginSource | String |
账号来源。 |
|
gmtCreate | Long |
创建账号的时间。 |
|
gmtModified | Long |
修改账号的时间。 |
|
loginName | String |
账号登录名称。 |
|
phone | String |
账号绑定的手机号码。 |
|
String |
账户绑定的邮箱。 |
||
nickName | String |
账户的昵称或别名。 |
|
tenantId | String |
租户的ID。 |
|
gender | String |
账户隶属者的性别。 |
|
lastLoginTime | Long |
上次登录的时间。 |
|
avatarUrl | String |
账户头像的URL地址。 |
|
onlineStatus | Int |
账号登录态是否在线。1(表示在线);0(表示离线)。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.4"
},
"params":{
"openId": "value0",
"openIdAppKey": "value1"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data":
{
"gmtModified":1515590332000,
"loginId":"4398050099996",
"gmtCreate":1513181985000,
"lastLoginTime":1515590332000,
"phone":"15757245467",
"identityId":"5091op618xxxxxxxxe93ba653a5928119",
"loginName":"15757245467",
"tenantId":"45CFEA7xxxxxxxx05D59452B1437",
"loginSource":"openAccount",
"email":"test@aliyun.com",
"nickName":"test"
}
,
"message":"success"
}
异常返回示例
JSON
格式
{}