批量获取用户详细信息

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

必需

示例值:

Bearer eyJhbGciB5DZtTWYVqa9A

Body 参数application/json

array[string]

用户GUID列表

可选

示例

[
    "1f83b588-aba3-4378-acd8-d59c71a8311d",
    "badParam"
]

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://accounts.zwsoft.cn/api/v1.0/users/getUsersInfo' \
--header 'Authorization: Bearer eyJhbGciB5DZtTWYVqa9A' \
--header 'Content-Type: application/json' \
--data-raw '[
    "1f83b588-aba3-4378-acd8-d59c71a8311d",
    "badParam"
]'

返回响应

🟢200成功

application/json

Body

status

integer

返回码

必需

详情请查看全局返回码

message

string

错误详细信息

必需

无错误时，返回：success

error

string | null

错误代号

必需

详情请查看全局返回码

data

array[object (用户详细信息) {23}]

返回数据

必需

无数据时为空列表

guid

string

用户GUID

必需

userName

string

用户名

必需

唯一，可用于索引用户

firstName

string | null

名字

必需

lastName

string | null

姓氏

必需

displayName

string

显示名称

必需

profileImage

string

头像链接

必需

已携带版本参数，若用户修改头像，则版本参数会自动变更

preferredLanguage

string

偏好语言

必需

国际语言代号

itc

string | null

手机国别号

必需

phone

string | null

手机号

必需

仅当scope有phone时返回

email

string | null

邮箱

必需

仅当scope有email时返回

accountState

enum<string>

账号状态

必需

枚举值:

NormalFreezeNotActive

securityStamp

string

安全戳

必需

当安全戳改变时，表明用户进行了安全操作，需要重新登录

region

string | null

所属地区

必需

用户最常登录IP的国家或地区代码

isEmployee

boolean

是否中望员工

必需

createTime

string

注册时间

必需

lastLoginTime

string

最后登录时间

必需

dateOfBirth

string | null

出生日期

必需

fromClient

string | null

用户来源

必需

客户端id

isPhoneReceiveInfo

boolean

手机号是否接收资讯

必需

是否接收产品更新\推广\活动等信息

isEmailReceiveInfo

boolean

邮箱是否接收资讯

必需

是否接收产品更新\推广\活动等信息

address

object

联系地址

必需

jobInfo

object

工作信息

必需

externalLoginInfos

array [object {3}]

第三方登录信息

必需

未绑定第三方时为空列表

示例

{
    "status": 0,
    "message": "success",
    "error": null,
    "data": [
        {
            "guid": "1f83b588-aba3-4378-acd8-d59c71a8311d",
            "firstName": "Zhang",
            "lastName": "San",
            "displayName": "San Zhang",
            "profileImage": "https://resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/sA9Cu0XTpirK95LBLFzUJe-nIoxcLaYgnbJYUBzDRqDyKp6A9CzX8HUWX-ktyG-q/originalPic.png",
            "preferredLanguage": "en-US",
            "userName": "zhangsan",
            "phone": null,
            "email": "zhangsan@test.com",
            "itc": null,
            "accountState": "Normal"
        }
    ]
}