基本信息说明
<h1>小程序后端接口 - 我的赛事模块</h1>
<h2>基本信息</h2>
<ul>
<li><strong>接口前缀</strong>: <code>/api/miniapp/events</code></li>
<li><strong>测试环境</strong>: <code>http://localhost:8888</code></li>
<li><strong>请求方式</strong>: GET</li>
<li><strong>数据格式</strong>: JSON</li>
<li><strong>认证方式</strong>: Bearer Token（自动获取用户ID，无需传递）</li>
</ul>
<h2>字段说明</h2>
<h3>赛事信息字段 (WmMyEvent)</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th>类型</th>
<th>说明</th>
<th>示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td>eventId</td>
<td>Long</td>
<td>赛事ID</td>
<td>1010</td>
</tr>
<tr>
<td>eventName</td>
<td>String</td>
<td>赛事名称</td>
<td>"2025 南京退役军人篮球联赛"</td>
</tr>
<tr>
<td>provinceCity</td>
<td>String</td>
<td>省份城市（合并字段）</td>
<td>"江苏省南京市"</td>
</tr>
<tr>
<td>site</td>
<td>String</td>
<td>报到地点</td>
<td>"南京市双拥活动中心篮球场"</td>
</tr>
<tr>
<td>applyStart</td>
<td>String</td>
<td>报名开始时间</td>
<td>"2025-08-30"</td>
</tr>
<tr>
<td>applyEnd</td>
<td>String</td>
<td>报名结束时间</td>
<td>"2025-09-15"</td>
</tr>
<tr>
<td>eventStart</td>
<td>String</td>
<td>赛事开始时间</td>
<td>"2025-09-20"</td>
</tr>
<tr>
<td>eventEnd</td>
<td>String</td>
<td>赛事结束时间</td>
<td>"2025-09-25"</td>
</tr>
<tr>
<td>principal</td>
<td>String</td>
<td>负责人</td>
<td>"钱峰"</td>
</tr>
<tr>
<td>phone</td>
<td>Long</td>
<td>联系电话</td>
<td>13000130010</td>
</tr>
<tr>
<td>level</td>
<td>Integer</td>
<td>赛事级别（1国家级、2省级、3市级）</td>
<td>2</td>
</tr>
<tr>
<td>category</td>
<td>String</td>
<td>赛事类别</td>
<td>"按军种分组，每组4队"</td>
</tr>
<tr>
<td>picture</td>
<td>String</td>
<td>赛事图片</td>
<td>"<a href="https://example.com/basketball10.jpg"">https://example.com/basketball10.jpg"</a>;</td>
</tr>
<tr>
<td>guideUnit</td>
<td>String</td>
<td>指导单位</td>
<td>"南京市双拥活动中心篮球场省体育局"</td>
</tr>
<tr>
<td>hostUnit</td>
<td>String</td>
<td>主办单位</td>
<td>"南京市双拥活动中心篮球场省体育局"</td>
</tr>
<tr>
<td>organizer</td>
<td>String</td>
<td>承办单位</td>
<td>"南京市双拥活动中心篮球场"</td>
</tr>
<tr>
<td>coOrganizer</td>
<td>String</td>
<td>协办单位</td>
<td>"青岛市政府"</td>
</tr>
<tr>
<td>supportUnit</td>
<td>String</td>
<td>支持单位</td>
<td>"山东省体育局"</td>
</tr>
<tr>
<td>competitionRegulations</td>
<td>String</td>
<td>竞赛规程</td>
<td>"每队10人，比赛4节每节10分钟..."</td>
</tr>
<tr>
<td>matchState</td>
<td>Integer</td>
<td>比赛状态(1为待开始，2为报名中，3为进行中，4己完成)</td>
<td>0</td>
</tr>
</tbody>
</table>
<hr />
<h2>状态说明</h2>
<table>
<thead>
<tr>
<th>状态值</th>
<th>状态描述</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>全部</td>
<td>显示所有赛事（默认值）</td>
</tr>
<tr>
<td>1</td>
<td>即将开始</td>
<td>赛事还未开始（eventStart > 当前时间）</td>
</tr>
<tr>
<td>2</td>
<td>报名中</td>
<td>正在接受报名（当前时间在 applyStart 和 applyEnd 之间）</td>
</tr>
<tr>
<td>3</td>
<td>进行中</td>
<td>赛事正在进行（当前时间在 eventStart 和 eventEnd 之间）</td>
</tr>
<tr>
<td>4</td>
<td>已完成</td>
<td>赛事已经结束（eventEnd < 当前时间）</td>
</tr>
</tbody>
</table>
<h2>接口使用说明</h2>
<p><strong>基础查询</strong>（返回所有赛事）:</p>
<pre><code>GET /api/miniapp/events/myevents</code></pre>
<p><strong>搜索查询</strong>:</p>
<pre><code>GET /api/miniapp/events/myevents?eventName=篮球</code></pre>
<p><strong>状态筛选</strong>:</p>
<pre><code>GET /api/miniapp/events/myevents?eventStatus=1</code></pre>
<p><strong>组合查询</strong>:</p>
<pre><code>GET /api/miniapp/events/myevents?eventStatus=1&amp;eventName=篮球</code></pre>
<p><strong>获取赛事详情</strong>:</p>
<pre><code>GET /api/miniapp/events/myevents?eventId=1010</code></pre>
<ul>
<li><strong>默认排序</strong>: 赛事列表按报名开始时间(<code>applyStart</code>)降序排列，最新开始报名的赛事会排在前面。</li>
</ul>