API文档

爱国 • 2025-04-08 10:14 • 帮助中心 • 阅读 25

API文档

一、

本API文档旨在为用户提供清晰、详细的接口信息，以便用户能够方便地使用我们的服务，以下将详细介绍各个接口的功能、请求参数、返回结果等内容。

（一）用户注册接口

{
    "username": "testuser",
    "password": "P@ssw0rd!",
    "email": "test@example.com"
}

接口名称	用户注册接口
接口描述	用于新用户在系统中进行注册操作
请求方式	POST
请求URL	https://api.example.com/register
请求参数
参数名	类型	必填	描述
username	string	是	用户名，长度3 16位，由字母、数字或下划线组成
password	string	是	密码，长度8 20位，需包含字母、数字和特殊字符
email	string	是	有效的电子邮箱地址
请求示例
返回结果
状态码	描述	返回示例
200	注册成功	{“code”: 200, “message”: “Registration successful”, “data”: null}
400	请求参数错误	{“code”: 400, “message”: “Invalid request parameters”, “data”: null}
500	服务器内部错误	{“code”: 500, “message”: “Internal server error”, “data”: null}

{
    "username": "testuser",
    "password": "P@ssw0rd!"
}

接口名称	用户登录接口
接口描述	已注册用户通过该接口进行登录验证
请求方式	POST
请求URL	https://api.example.com/login
请求参数
参数名	类型	必填	描述
username	string	是	注册时使用的用户名
password	string	是	注册时设置的密码
请求示例
返回结果
状态码	描述	返回示例
200	登录成功	{“code”: 200, “message”: “Login successful”, “data”: {“token”: “eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…”}}
401	用户名或密码错误	{“code”: 401, “message”: “Invalid username or password”, “data”: null}
500	服务器内部错误	{“code”: 500, “message”: “Internal server error”, “data”: null}

接口名称	获取用户信息接口
接口描述	用户登录后，可通过该接口获取自己的详细信息
请求方式	GET
请求URL	https://api.example.com/user/info
请求参数	无
请求示例	无
返回结果
状态码	描述	返回示例
200	获取成功	{“code”: 200, “message”: “User info retrieved successfully”, “data”: {“username”: “testuser”, “email”: “test@example.com”, “created_at”: “2024-01-01T12:00:00Z”}}
401	未登录或登录过期	{“code”: 401, “message”: “Unauthorized”, “data”: null}
500	服务器内部错误	{“code”: 500, “message”: “Internal server error”, “data”: null}