QuesBank提供了完整的RESTful API接口,支持题库管理、用户认证、学习进度跟踪等功能。 本文档详细介绍了所有可用的API接口及其使用方法。
基础URL: http://your-domain.com/api/
数据格式: JSON
字符编码: UTF-8
除了登录和注册接口外,其他所有接口都需要进行身份认证。 认证方式采用Session机制,需要在请求头中包含有效的Session ID。
{
"username": "admin",
"password": "123456"
}
{
"code": 200,
"message": "登录成功",
"data": {
"user": {
"id": 1,
"username": "admin",
"role": "admin",
"email": "admin@example.com"
},
"session_id": "abc123def456"
}
}
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400 | 请求参数错误 | 检查请求参数格式和必填项 |
| 401 | 未授权访问 | 请先登录获取认证信息 |
| 403 | 权限不足 | 检查用户角色和权限 |
| 404 | 资源不存在 | 检查请求的资源ID是否正确 |
| 500 | 服务器内部错误 | 请联系管理员或稍后重试 |
{
"code": 400,
"message": "参数错误",
"data": {
"errors": {
"username": ["用户名不能为空"],
"password": ["密码长度不能少于6位"]
}
}
}
更多详细的API接口信息,请参考 API接口文档.md 文件。