参赛球队
<h1>获取已报名参加比赛的球队列表</h1>
<h2>接口信息</h2>
<ul>
<li><strong>接口名称</strong>: 获取已报名参加比赛的球队列表（增强版）</li>
<li><strong>接口描述</strong>: 获取已报名参加比赛且报名状态为"已通过"的球队列表，包含完整的球队信息</li>
<li><strong>请求URL</strong>: <code>/api/team/registeredTeams</code></li>
<li><strong>请求方式</strong>: <code>GET</code></li>
<li><strong>认证方式</strong>: 匿名访问（@Anonymous）</li>
</ul>
<h2>请求参数</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">示例值</th>
<th>必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">无</td>
<td style="text-align: left;">-</td>
<td>-</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">无需传递任何参数</td>
</tr>
</tbody>
</table>
<h2>响应示例</h2>
<h3>成功响应</h3>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;teamId&quot;: 101,
&quot;teamName&quot;: &quot;篮球队A&quot;,
&quot;teamType&quot;: &quot;A&quot;,
&quot;teamTypeName&quot;: &quot;整建制&quot;,
&quot;leaderName&quot;: &quot;张三&quot;,
&quot;leaderPhone&quot;: &quot;13800138000&quot;,
&quot;managerName&quot;: &quot;李四&quot;,
&quot;managerPhone&quot;: &quot;13900139000&quot;,
&quot;headCoachName&quot;: &quot;王五&quot;,
&quot;headCoachPhone&quot;: &quot;13700137000&quot;,
&quot;assistantCoachName&quot;: &quot;赵六&quot;,
&quot;assistantCoachPhone&quot;: &quot;13600136000&quot;,
&quot;doctorName&quot;: &quot;孙七&quot;,
&quot;doctorPhone&quot;: &quot;13500135000&quot;,
&quot;province&quot;: &quot;广东省&quot;,
&quot;city&quot;: &quot;深圳市&quot;,
&quot;address&quot;: &quot;南山区科技园&quot;,
&quot;teamLogo&quot;: &quot;path/team_logo.jpg&quot;,
&quot;status&quot;: &quot;1&quot;,
&quot;statusName&quot;: &quot;正常&quot;,
&quot;memberNum&quot;: 15,
&quot;createTime&quot;: &quot;2025-01-27 10:00:00&quot;,
&quot;updateTime&quot;: &quot;2025-01-27 10:00:00&quot;,
&quot;createDeadline&quot;: &quot;2025-12-31&quot;,
&quot;dissolveTime&quot;: null,
&quot;remark&quot;: &quot;专业篮球队&quot;
},
{
&quot;teamId&quot;: 102,
&quot;teamName&quot;: &quot;篮球队B&quot;,
&quot;teamType&quot;: &quot;B&quot;,
&quot;teamTypeName&quot;: &quot;个人组队&quot;,
&quot;leaderName&quot;: &quot;赵六&quot;,
&quot;leaderPhone&quot;: &quot;13600136000&quot;,
&quot;managerName&quot;: &quot;孙七&quot;,
&quot;managerPhone&quot;: &quot;13500135000&quot;,
&quot;headCoachName&quot;: &quot;周八&quot;,
&quot;headCoachPhone&quot;: &quot;13400134000&quot;,
&quot;assistantCoachName&quot;: &quot;吴九&quot;,
&quot;assistantCoachPhone&quot;: &quot;13300133000&quot;,
&quot;doctorName&quot;: &quot;郑十&quot;,
&quot;doctorPhone&quot;: &quot;13200132000&quot;,
&quot;province&quot;: &quot;广东省&quot;,
&quot;city&quot;: &quot;广州市&quot;,
&quot;address&quot;: &quot;天河区体育中心&quot;,
&quot;teamLogo&quot;: &quot;path/team_logo_b.jpg&quot;,
&quot;status&quot;: &quot;1&quot;,
&quot;statusName&quot;: &quot;正常&quot;,
&quot;memberNum&quot;: 12,
&quot;createTime&quot;: &quot;2025-01-26 15:30:00&quot;,
&quot;updateTime&quot;: &quot;2025-01-26 15:30:00&quot;,
&quot;createDeadline&quot;: &quot;2025-12-31&quot;,
&quot;dissolveTime&quot;: null,
&quot;remark&quot;: &quot;业余篮球队&quot;
}
],
&quot;total&quot;: 2
}
}</code></pre>
<h3>空数据响应</h3>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: {
&quot;list&quot;: [],
&quot;total&quot;: 0
}
}</code></pre>
<h3>错误响应</h3>
<pre><code class="language-json">{
&quot;code&quot;: 500,
&quot;msg&quot;: &quot;操作失败&quot;,
&quot;data&quot;: &quot;查询失败：数据库连接或SQL执行异常&quot;
}</code></pre>
<h2>响应参数说明</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">响应状态码（200=成功 500=失败）</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">响应消息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">响应数据</td>
</tr>
<tr>
<td style="text-align: left;">data.list</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;">已报名球队列表</td>
</tr>
<tr>
<td style="text-align: left;">data.total</td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">已报名球队总数</td>
</tr>
</tbody>
</table>
<h3>球队信息字段说明</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">data.list.teamId</td>
<td style="text-align: left;">long</td>
<td style="text-align: left;">球队ID</td>
</tr>
<tr>
<td style="text-align: left;">data.list.teamName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队名称</td>
</tr>
<tr>
<td style="text-align: left;">data.list.teamType</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队类型（A=整建制 B=个人组队）</td>
</tr>
<tr>
<td style="text-align: left;">data.list.teamTypeName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队类型名称</td>
</tr>
<tr>
<td style="text-align: left;">data.list.leaderName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">领队姓名</td>
</tr>
<tr>
<td style="text-align: left;">data.list.leaderPhone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">领队联系方式</td>
</tr>
<tr>
<td style="text-align: left;">data.list.managerName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队负责人姓名</td>
</tr>
<tr>
<td style="text-align: left;">data.list.managerPhone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">负责人联系方式</td>
</tr>
<tr>
<td style="text-align: left;">data.list.headCoachName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">主教练姓名</td>
</tr>
<tr>
<td style="text-align: left;">data.list.headCoachPhone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">主教练联系方式</td>
</tr>
<tr>
<td style="text-align: left;">data.list.assistantCoachName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">助理教练姓名</td>
</tr>
<tr>
<td style="text-align: left;">data.list.assistantCoachPhone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">助理教练联系方式</td>
</tr>
<tr>
<td style="text-align: left;">data.list.doctorName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">队医姓名</td>
</tr>
<tr>
<td style="text-align: left;">data.list.doctorPhone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">队医联系方式</td>
</tr>
<tr>
<td style="text-align: left;">data.list.province</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">所在省份</td>
</tr>
<tr>
<td style="text-align: left;">data.list.city</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">所在城市</td>
</tr>
<tr>
<td style="text-align: left;">data.list.address</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">详细地址</td>
</tr>
<tr>
<td style="text-align: left;">data.list.teamLogo</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队Logo路径</td>
</tr>
<tr>
<td style="text-align: left;">data.list.status</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队状态（0=禁用 1=正常）</td>
</tr>
<tr>
<td style="text-align: left;">data.list.statusName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">球队状态名称</td>
</tr>
<tr>
<td style="text-align: left;">data.list.memberNum</td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">成员数量</td>
</tr>
<tr>
<td style="text-align: left;">data.list.createTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">创建时间</td>
</tr>
<tr>
<td style="text-align: left;">data.list.updateTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">更新时间</td>
</tr>
<tr>
<td style="text-align: left;">data.list.createDeadline</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">创建截止时间</td>
</tr>
<tr>
<td style="text-align: left;">data.list.dissolveTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">解散时间（如有）</td>
</tr>
<tr>
<td style="text-align: left;">data.list.remark</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">备注信息</td>
</tr>
</tbody>
</table>
<h2>使用说明</h2>
<ol>
<li><strong>报名状态过滤</strong>: 只返回报名状态为"已通过"的球队</li>
<li><strong>匿名访问</strong>: 无需登录即可调用此接口</li>
<li><strong>完整信息</strong>: 返回球队的完整基本信息</li>
<li><strong>排序规则</strong>: 按球队创建时间倒序排列</li>
<li><strong>状态过滤</strong>: 只返回正常状态的球队</li>
</ol>
<h2>功能说明</h2>
<p>此接口通过以下逻辑获取已报名球队：</p>
<ul>
<li><strong>关联查询</strong>: 通过 <code>wm_team</code> 表和 <code>wm_match_team</code> 表关联查询</li>
<li><strong>状态过滤</strong>: 只返回 <code>registration_status = &#039;已通过&#039;</code> 的球队</li>
<li><strong>去重处理</strong>: 使用 DISTINCT 确保每个球队只出现一次</li>
<li><strong>完整信息</strong>: 返回球队的所有基本信息字段</li>
</ul>
<h2>数据库查询逻辑</h2>
<pre><code class="language-sql">SELECT
t.team_id, t.team_name, t.status, t.member_num,
t.leader_name, t.leader_phone, t.head_coach_name,
t.head_coach_phone, t.province, t.city, t.address,
t.team_logo, t.create_time, t.update_time
FROM wm_team t
WHERE t.team_id IN (
SELECT DISTINCT mt.team_id
FROM wm_match_team mt
WHERE mt.registration_status = &#039;已通过&#039;
)
ORDER BY t.create_time DESC</code></pre>
<h2>使用场景</h2>
<ul>
<li><strong>赛事管理</strong>: 查看已报名参加比赛的球队</li>
<li><strong>比赛安排</strong>: 为比赛安排提供参赛球队信息</li>
<li><strong>统计报表</strong>: 统计参赛球队数量和分布</li>
<li><strong>公开展示</strong>: 在官网或小程序展示参赛球队</li>
<li><strong>数据导出</strong>: 导出参赛球队信息用于其他系统</li>
</ul>
<h2>注意事项</h2>
<ul>
<li><strong>无需参数</strong>: 不需要传递任何请求参数</li>
<li><strong>时间格式</strong>: 返回的时间格式为 <code>YYYY-MM-DD HH:mm:ss</code></li>
<li><strong>空数据处理</strong>: 如果没有已报名的球队，会返回空数组</li>
<li><strong>异常处理</strong>: 接口会自动处理异常情况并返回相应的错误信息</li>
<li><strong>性能优化</strong>: 使用子查询优化SQL性能</li>
</ul>
<h2>错误处理</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">错误码</th>
<th style="text-align: left;">错误信息</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">500</td>
<td style="text-align: left;">查询失败：数据库连接或SQL执行异常</td>
<td style="text-align: left;">数据库连接问题或SQL执行异常</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td style="text-align: left;">获取已报名球队列表失败</td>
<td style="text-align: left;">其他系统异常</td>
</tr>
</tbody>
</table>
<h2>相关接口</h2>
<ul>
<li><a href="2.获取球队详情-增强版.md">获取球队详情（增强版）</a> - 获取具体球队的详细信息</li>
<li><a href="4.获取球队成员列表-增强版.md">获取球队成员列表（增强版）</a> - 查看球队成员信息</li>
<li><a href="21.根据用户ID查找球队-增强版.md">根据用户ID查找球队（增强版）</a> - 查找用户相关的球队</li>
</ul>