修改用户基本信息

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer eyJhbGciB5DZtTWYVqa9A

Body 参数application/json

firstName

string | null

名字

可选

不可为纯空格，为空值时将被”-“ 替代

lastName

string | null

姓氏

可选

不可为纯空格，为空值时将被”-“ 替代

displayName

string | null

显示名称

可选

不可为空值，不可为纯空格

preferredLanguage

string | null

偏好语言

可选

标准语言代号，如：zh-CN

示例

{
    "firstName": "San",
    "lastName": "Zhang",
    "displayName": "San Zhang",
    "preferredLanguage": "en-US"
}

示例代码

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/basic' \
--header 'Authorization: Bearer eyJhbGciB5DZtTWYVqa9A' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstName": "San",
    "lastName": "Zhang",
    "displayName": "San Zhang",
    "preferredLanguage": "en-US"
}'

返回响应

🟢200成功

application/json

Body

status

integer

返回码

必需

详情请查看全局返回码

message

string

错误详细信息

必需

无错误时，返回：success

error

string | null

错误代号

必需

详情请查看全局返回码

data

array[object (用户基本信息) {16}]

返回数据

必需

无数据时为空列表

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

最后登录时间

必需

示例

{
    "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"
        }
    ]
}