批量查询用户GUID - 中望帐号

需要scope：ZMS.Users.Read

返回查询条件：逐一查询，效率较低，一个查询条件仅返回一个结果

不返回查询条件：合并查询，效率较高，无序返回所有符合条件的结果，若同一条件有多个账号将全部返回

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

returnFinder

string

可选

是否需要返回查询条件，默认true

Body 参数application/json

array[string]

查询条件列表

可选

邮箱\用户名\手机号；每个字符串为一个单独的用户查询，无效的查询字段将被跳过

示例

[
    "testa@test.com",
    "zhangsan",
    "+8617600001111",
    "badParam"
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功(返回查询条件)

application/json

Body

status

integer

返回码

必需

详情请查看全局返回码

message

string

错误详细信息

必需

无错误时，返回：success

error

string | null

错误代号

必需

详情请查看全局返回码

data

array [object {2}]

返回数据

必需

无数据时为空列表

guid

string

用户GUID

必需

finder

string

查询条件

必需

传入的查询条件

示例

成功示例 (返回查询条件)成功示例 (不返回查询条件)

{
    "status": 0,
    "message": "success",
    "error": null,
    "data": [
        {
            "guid": "325c63e8-3cbb-49c4-8284-b219783d13a4",
            "finder": "testa@test.com"
        },
        {
            "guid": "fca2a896-484e-4551-9977-70eaaf6aa446",
            "finder": "zhangsan"
        },
        {
            "guid": "baeacc6e-84ca-45b5-899d-e998274fcc0f",
            "finder": "+8617600001111"
        }
    ]
}

🟢200成功(不返回查询条件)