中望帐号

解绑用户手机号\邮箱\第三方

设计中

正式环境

https://accounts.zwsoft.cn

POST

/api/v1.0/manage/users/security/unbind

最后修改时间：2025-06-04 07:32:54

需要role：Account.UserManager

必须为用户保留一种有效的登录方式：手机号\邮箱\第三方

操作	provider值
解绑邮箱	email
解绑手机号	phone
解绑第三方	传第三方provider，例如解绑微信时，应传：WeChat

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

必需

示例值:

Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjYyV2ozZjMzUjFGUFlLNlI3cjQxZ1EiLCJ0eXAiOiJhdCtqd3QifQ.eyJuYmYiOjE3NDkwMTg2MDIsImV4cCI6MTc0OTAyNTgwMiwiaXNzIjoiaHR0cHM6Ly90ZXN0YWNjb3VudHMuendzb2Z0LmNuIiwiYXVkIjpbIlNBTV9BUEkiLCJaTVMuVXNlciJdLCJjbGllbnRfaWQiOiJaV01lU3lzdGVtQ2xpZW50Iiwic3ViIjoiYWY4ZGE0YTctN2Q0Yi00ZDBmLTg4MGYtYTJiZmM3NjczMDRjIiwiYXV0aF90aW1lIjoxNzQ4OTM3MDU3LCJpZHAiOiJsb2NhbCIsInJvbGUiOiJBY2NvdW50LlVzZXJNYW5hZ2VyIiwiY29ycGlkIjoiendzb2Z0LWIwNTM2YzJhLTVkY2MtYjQ4YS1hZjVjLTkxN2ExM2RiMDFjYiIsImNvcnBOYW1lIjoiendzb2Z0LWIwNTM2YzJhLTVkY2MtYjQ4YS1hZjVjLTkxN2ExM2RiMDFjYiIsInNjb3BlIjpbIm9wZW5pZCIsInByb2ZpbGUiLCJlbWFpbCIsInBob25lIiwib2ZmbGluZV9hY2Nlc3MiLCJTQU1fQVBJIiwiU0FNLk9yZGVyLlJlYWQiLCJTQU0uTGljZW5zZS5DaGFuZ2UiLCJaTVMuVXNlckRldGFpbHMuUmVhZCIsIlpNUy5Vc2VyRGV0YWlscy5Xcml0ZSJdLCJhbXIiOlsicHdkIl19.LgkZTEDleyLAVekc5YvZF2OrjViPaY871cumnQG8jZYlQdRwFSR4w64Kvccjd-7-VuDqsNk9aARXy6AvifxuxDTZPp-bsOjG52rEomLard_qNneBC85_4pqrd40Qu1yUzyIQf9BZTmFbrDngLtvahkjqQIxvGDrOKJ4K_cIUS0BxebYIOp3fdYmX2lNMGxcuRjfMegj-6yiF1hC5Nt0RA6_VIteyQl0UjIPus_6uIBxUxB22w6y7KJrq8t7VU9Cmhd-cl1yzqGwpVrdvbzuwsibYmHeABVY7pHn5-Tdw5GYQBHjbiY5hNiNp0dV66r2azVDjF5Ikja_xzNw-BjFKlg

Body 参数application/json

guid

string

用户guid

必需

provider

string

解绑对象

必需

示例

{
    "guid": "string",
    "provider": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://accounts.zwsoft.cn/api/v1.0/manage/users/security/unbind' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjYyV2ozZjMzUjFGUFlLNlI3cjQxZ1EiLCJ0eXAiOiJhdCtqd3QifQ.eyJuYmYiOjE3NDkwMTg2MDIsImV4cCI6MTc0OTAyNTgwMiwiaXNzIjoiaHR0cHM6Ly90ZXN0YWNjb3VudHMuendzb2Z0LmNuIiwiYXVkIjpbIlNBTV9BUEkiLCJaTVMuVXNlciJdLCJjbGllbnRfaWQiOiJaV01lU3lzdGVtQ2xpZW50Iiwic3ViIjoiYWY4ZGE0YTctN2Q0Yi00ZDBmLTg4MGYtYTJiZmM3NjczMDRjIiwiYXV0aF90aW1lIjoxNzQ4OTM3MDU3LCJpZHAiOiJsb2NhbCIsInJvbGUiOiJBY2NvdW50LlVzZXJNYW5hZ2VyIiwiY29ycGlkIjoiendzb2Z0LWIwNTM2YzJhLTVkY2MtYjQ4YS1hZjVjLTkxN2ExM2RiMDFjYiIsImNvcnBOYW1lIjoiendzb2Z0LWIwNTM2YzJhLTVkY2MtYjQ4YS1hZjVjLTkxN2ExM2RiMDFjYiIsInNjb3BlIjpbIm9wZW5pZCIsInByb2ZpbGUiLCJlbWFpbCIsInBob25lIiwib2ZmbGluZV9hY2Nlc3MiLCJTQU1fQVBJIiwiU0FNLk9yZGVyLlJlYWQiLCJTQU0uTGljZW5zZS5DaGFuZ2UiLCJaTVMuVXNlckRldGFpbHMuUmVhZCIsIlpNUy5Vc2VyRGV0YWlscy5Xcml0ZSJdLCJhbXIiOlsicHdkIl19.LgkZTEDleyLAVekc5YvZF2OrjViPaY871cumnQG8jZYlQdRwFSR4w64Kvccjd-7-VuDqsNk9aARXy6AvifxuxDTZPp-bsOjG52rEomLard_qNneBC85_4pqrd40Qu1yUzyIQf9BZTmFbrDngLtvahkjqQIxvGDrOKJ4K_cIUS0BxebYIOp3fdYmX2lNMGxcuRjfMegj-6yiF1hC5Nt0RA6_VIteyQl0UjIPus_6uIBxUxB22w6y7KJrq8t7VU9Cmhd-cl1yzqGwpVrdvbzuwsibYmHeABVY7pHn5-Tdw5GYQBHjbiY5hNiNp0dV66r2azVDjF5Ikja_xzNw-BjFKlg' \
--header 'Content-Type: application/json' \
--data-raw '{
    "guid": "string",
    "provider": "string"
}'

返回响应

🟢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时返回

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": "1fs3b587-aba3-4778-acd8-d59c71a8516c",
            "firstName": "三",
            "lastName": "张",
            "displayName": "张三",
            "profileImage": "https://resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/pA9Cv0XTpirK52LBLFzUJe-nIabcLaYgnbJYUBzDRqDyKp6A9CzX8HUWX-ktyG-y/originalPic.png",
            "preferredLanguage": "zh-CN",
            "dateOfBirth": "1997-01-01",
            "address": {
                "street": "珠江西路15号",
                "postalCode": "510623",
                "city": "广州市-天河区",
                "provinceName": "广东省",
                "countryName": "中国",
                "countryCode": "CN"
            },
            "jobInfo": {
                "company": "中望龙腾软件股份有限公司",
                "industry": "计算机",
                "department": "研发中台",
                "title": "测试工程师"
            },
            "userName": "zhangsan",
            "itc": "+86",
            "phone": "17645678902",
            "email": "zhangsan@test.com",
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": true,
            "externalLoginInfos": [
                {
                    "provider": "WeChat",
                    "displayName": "Mono",
                    "externalID": "ashbijsiaohohuIHO56asd54"
                }
            ],
            "accountState": "Normal"
        }
    ]
}

修改于 2025-06-04 07:32:54

修改用户安全信息

获取角色组列表