用户登录接口

POST

/user-center/login

用户登录接口
【v3.1.0更新】
resp 添加 fullname，前端需要通过 fullname 来显示右上角的用户名
【v3.4.0更新】
req 添加 captchaId 和 captchaAnswer，支持验证码登录
添加登录失败锁定功能，密码错误次数过多会临时锁定账户
添加密码强度校验：8-64字符，至少包含3种字符类型

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "userName": "string",
    "passHash": "string",
    "captchaId": "string",
    "captchaAnswer": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/user-center/login' \
--header 'Authorization: eyJhbGciOiJIUzI1Ni1TTTMiLCJ0eXAiOiJKV1QifQ.eyJleHAiOjE3NzUwMzA0MDYsImlhdCI6MTc3NTAyMzIwNiwiaXNzdWVyIjoiZ2F0ZXdheSIsInR5cGUiOiJ0b2tlbiIsInVzZXJfaWQiOjJ9.mBF7H9M7j0yr7MavFTX8rc1D7CG4OqFGqGWhtNyiMms' \
--header 'Content-Type: application/json' \
--data '{
    "userName": "string",
    "passHash": "string",
    "captchaId": "string",
    "captchaAnswer": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "baseResponse": {
        "code": 0,
        "msg": "string"
    },
    "data": {
        "userName": "string",
        "roleId": 0,
        "token": "string",
        "expiresIn": "string",
        "refreshToken": "string",
        "refreshExpiresIn": "string",
        "tenantId": "string",
        "uin": "string",
        "roleType": 0,
        "fullName": "string",
        "enterpriseData": {
            "did": "string",
            "type": 0,
            "disable": true,
            "authTime": "string",
            "authType": 0,
            "authStatus": 0,
            "enterpriseName": "string",
            "expiresAt": "string",
            "legalPerson": "string",
            "usci": "string"
        }
    }
}

🟢200成功

修改于 2026-03-18 03:00:15

查询api数据

用户登出