获取场馆/约战列表
<h3>简要描述</h3>
<ul>
<li>获取(发布状态的)场馆约战列表数据,支持搜索和标签页筛选</li>
</ul>
<h3>请求URL</h3>
<ul>
<li><code>/api/stadium/fight/list</code></li>
</ul>
<h3>请求方式</h3>
<ul>
<li>GET</li>
</ul>
<h3>参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名 </th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型 </th>
<th style="text-align: center;"> 说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">type </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int </td>
<td style="text-align: center;">列表类型:0-场馆列表,1-我的约战</td>
</tr>
<tr>
<td style="text-align: left;">city </td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 城市,默认为用户所在城市 </td>
</tr>
<tr>
<td style="text-align: left;">venue_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 场馆名称,默认为空 </td>
</tr>
<tr>
<td style="text-align: left;">page </td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int </td>
<td style="text-align: center;"> 页码,默认为1 </td>
</tr>
<tr>
<td style="text-align: left;">pageSize </td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int </td>
<td style="text-align: center;"> 每页数量,默认为10 </td>
</tr>
<tr>
<td style="text-align: left;">date </td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 日期(模糊匹配),type=1时可传入 </td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<p>type==0</p>
<pre><code class="language-json">{
&quot;error_code&quot;: 0,
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;id&quot;: 1,
&quot;name&quot;: &quot;城市运动中心篮球馆&quot;,
&quot;city&quot;: &quot;北京市朝阳区&quot;,
&quot;address&quot;: &quot;朝阳区体育中心3号楼&quot;,
&quot;venue_field&quot;: &quot;一号场&quot;,
&quot;connect_person&quot;: &quot;郑队长&quot;,
&quot;connect_phone&quot;: &quot;010-87654321&quot;,
&quot;time&quot;: &quot;14:00-15:00&quot;,
&quot;teamA_last&quot;: 3,
&quot;teamB_last&quot;: 3,
&quot;cover_photo&quot;: &quot;/profile/upload/2025/08/14/5e1ae0a6-703a-11f0-af1f-2601d5e31493_00000_raw_20250814154937A001.jpeg&quot;
}
],
&quot;total&quot;: 100,
&quot;page&quot;: 1,
&quot;pageSize&quot;: 10
}
}</code></pre>
<p>type==1</p>
<pre><code class="language-json">{
&quot;error_code&quot;: 0,
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;id&quot;: 1,
&quot;name&quot;: &quot;城市运动中心篮球馆&quot;,
&quot;city&quot;: &quot;北京市朝阳区&quot;,
&quot;venue_field&quot;: &quot;一号场&quot;,
&quot;date&quot;: &quot;2019-07-01&quot;,
&quot;time&quot;: &quot;14:00-15:00&quot;,
&quot;status&quot;: &quot;进行中&quot;,
&quot;cover_photo&quot;: &quot;/profile/upload/2025/08/14/5e1ae0a6-703a-11f0-af1f-2601d5e31493_00000_raw_20250814154937A001.jpeg&quot;
}
],
&quot;total&quot;: 100,
&quot;page&quot;: 1,
&quot;pageSize&quot;: 10
}
}</code></pre>
<h3>返回参数说明</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名 </th>
<th style="text-align: left;">类型</th>
<th style="text-align: center;"> 说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">list </td>
<td style="text-align: left;">array</td>
<td style="text-align: center;"> 场馆/约战列表数据 </td>
</tr>
<tr>
<td style="text-align: left;">id </td>
<td style="text-align: left;">int</td>
<td style="text-align: center;"> 场馆/约战ID </td>
</tr>
<tr>
<td style="text-align: left;">name </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 场馆名称 </td>
</tr>
<tr>
<td style="text-align: left;">city </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 城市 </td>
</tr>
<tr>
<td style="text-align: left;">address </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 场馆地址 </td>
</tr>
<tr>
<td style="text-align: left;">venue_field</td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 场馆场地 </td>
</tr>
<tr>
<td style="text-align: left;">phone </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 联系电话 </td>
</tr>
<tr>
<td style="text-align: left;">date </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 日期 </td>
</tr>
<tr>
<td style="text-align: left;">time </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 时间段 </td>
</tr>
<tr>
<td style="text-align: left;">teamA_last</td>
<td style="text-align: left;">int</td>
<td style="text-align: center;"> 深色队剩余名额(今天的) </td>
</tr>
<tr>
<td style="text-align: left;">teamB_last</td>
<td style="text-align: left;">int</td>
<td style="text-align: center;"> 浅色队剩余名额(今天的) </td>
</tr>
<tr>
<td style="text-align: left;">status </td>
<td style="text-align: left;">string</td>
<td style="text-align: center;">状态:未开始/进行中/已结束,约战列表才有这一项</td>
</tr>
<tr>
<td style="text-align: left;">total </td>
<td style="text-align: left;">int</td>
<td style="text-align: center;"> 总记录数 </td>
</tr>
<tr>
<td style="text-align: left;">page </td>
<td style="text-align: left;">int</td>
<td style="text-align: center;"> 当前页码 </td>
</tr>
<tr>
<td style="text-align: left;">pageSize </td>
<td style="text-align: left;">int</td>
<td style="text-align: center;"> 每页数量 </td>
</tr>
<tr>
<td style="text-align: left;">cover_photo</td>
<td style="text-align: left;">string</td>
<td style="text-align: center;"> 封面图片路径 </td>
</tr>
</tbody>
</table>
<h3>备注</h3>
<ul>
<li>返回发布状态的场馆</li>
</ul>