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 文件。