API文档

HQCTF平台提供RESTful API接口,支持程序化访问平台功能。
认证相关
  • POST /api/v1/auth/login - 用户登录
  • POST /api/v1/auth/logout - 用户登出
  • GET /api/v1/users/profile - 获取用户信息
竞赛相关
  • GET /api/contests - 获取竞赛列表
  • GET /api/dashboard/{id}/stats - 获取竞赛统计
  • POST /api/contests/{id}/register - 报名竞赛
挑战相关
  • GET /api/challenges - 获取挑战列表
  • POST /api/challenges/{id}/submit - 提交Flag
  • GET /api/challenges/{id}/status - 获取挑战状态

认证方式

API使用基于Session的认证方式,需要先通过登录接口获取认证信息。

响应格式

所有API响应都使用JSON格式:

{
  "success": true,
  "data": {...},
  "message": "操作成功"
}

错误处理

错误响应格式:

{
  "success": false,
  "error": "错误代码",
  "message": "错误描述"
}