查询同一个租户ID或隔离ID下的统一身份列表。
路径 | /iotx/account/queryIdentityList |
版本号 | 1.0.6 |
协议 | HTTP,HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 否 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
identityIds | List | 是 | ["1","2","3"] | 统一身份ID数组 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
message | String |
调用失败时,返回的出错信息。 |
|
localizedMsg | String |
本地语言的错误消息。 |
|
data | JSON |
响应结果。 |
|
tenantId | String |
租户的ID。 |
|
identityId | String |
统一身份ID。 |
|
nickName | String |
昵称。 |
|
loginName | String |
登录名。 |
|
phone | String |
手机号。 |
|
String |
邮箱地址。 |
||
avatarUrl | String |
头像地址。 |
示例
请求示例
// https://github.com/aliyun/iotx-api-gateway-client
IoTApiClientBuilderParams ioTApiClientBuilderParams = new IoTApiClientBuilderParams();
ioTApiClientBuilderParams.setAppKey("你的<AppKey>");
ioTApiClientBuilderParams.setAppSecret("你的<AppSecret>");
SyncApiClient syncApiClient = new SyncApiClient(ioTApiClientBuilderParams);
IoTApiRequest request = new IoTApiRequest();
// 设置请求ID
String uuid = UUID.randomUUID().toString();
String id = uuid.replace("-", "");
request.setId(id);
// 设置API版本号
request.setApiVer("1.0.6");
// 设置参数
request.putParam("identityIds", "value0");
// 如果需要,设置headers
Map<String, String> headers = new HashMap<String, String>(8);
// headers.put("你的<header", "你的<value>");
// 设置请求参数域名, path, request, isHttps, headers
ApiResponse response = syncApiClient.postBody("api.link.aliyun.com", "/iotx/account/queryIdentityList", request, true, headers);
System.out.println(
"response code = " + response.getCode()
+ " response = " + new String(response.getBody(), "UTF-8")
+ " headers = " + response.getHeaders().toString()
);
正常返回示例
JSON
格式
{
"code": 200,
"data": [
{
"tenantId": "*********",
"identityId": "*********",
"nickName": "hello",
"loginName": "abc",
"phone": "openAccount",
"email": "qq@bb.com",
"avatarUrl": "http://www.aa.com/a.jpg"
}
],
"id": "*********"
}
异常返回示例
JSON
格式
{
"code":460,
"id":"*********",
"localizedMsg":"请求错误",
"message":"requestparametererror"
}