网站建设 邦注册的空间网站

接口描述

该接口用于用户登录验证。通过用户名和密码进行身份验证，成功后返回一个用于后续请求的认证 token。这个 token 是访问受保护资源的凭证。

时序图：

登录请求：

登录查询接口:

POST {url}/api/user/login

请求体:

{"username": "exampleUser","password": "examplePassword"
}

请求参数列表

响应示例

成功响应

1. 状态码: 200 OK
2. 类型: LoginResp

3. {"code": 0,"message": "Success","data":{"token": "123456789abcdef"
   }
   }
   

用户名不存在错误响应

1. 状态码: 401 Unauthorized
2. 类型: ErrorResponse

{"code": 401,"message": "Unauthorized username","data": 
}

密码错误错误响应

1. 状态码: 401 Unauthorized
2. 类型: ErrorResponse

{"code": 401,"message": "Unauthorized","data": "密码错误"
}

公钥与私钥不匹配错误响应

1. 状态码: 401 Unauthorized
2. 类型: ErrorResponse

{"code": 401,"message": "Invalid Credentials","data": "公钥与私钥不匹配"
}

Token生成错误响应

1. 状态码: 500 Internal Server Error
2. 类型: ErrorResponse

{"code": 500,"message": "Token Generation Failed","data": "服务器生成token失败，请重试"
}

服务器内部错误响应

1. 状态码: 500 Internal Server Error
2. 类型: ErrorResponse

{"code": 500,"message": "Internal Server Error","data": "服务器内部错误"
}

 状态码与响应消息

使用场景

1. 登录功能: 用户通过提供用户名和密码登录系统。
2. 身份验证: 登录成功后返回的 token 用于后续请求的身份验证。