赛事公示列表
<h1>赛事公示列表接口文档</h1>
<h2>简要描述</h2>
<ul>
<li>赛事公示列表（用于小程序“赛事公示”页面）。支持按赛事名称、省、市、公示状态筛选；返回不含队伍数量的赛事公告列表。</li>
</ul>
<h2>请求URL</h2>
<ul>
<li><code>/api/match/list</code></li>
</ul>
<h2>请求方式</h2>
<ul>
<li><code>GET</code></li>
</ul>
<h2>参数</h2>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>eventName</td>
<td>否</td>
<td>string</td>
<td>赛事名称（模糊）</td>
</tr>
<tr>
<td>province</td>
<td>否</td>
<td>string</td>
<td>省份名称，如：山东省</td>
</tr>
<tr>
<td>city</td>
<td>否</td>
<td>string</td>
<td>城市名称，如：青岛市</td>
</tr>
<tr>
<td>state</td>
<td>否</td>
<td>integer</td>
<td>公示状态：0未公示 1已公示</td>
</tr>
</tbody>
</table>
<h2>返回示例</h2>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;list&quot;: [
{
&quot;eventId&quot;: 1001,
&quot;eventName&quot;: &quot;2025青岛春季篮球联赛-少年组邀请赛&quot;,
&quot;province&quot;: &quot;山东省&quot;,
&quot;city&quot;: &quot;青岛市&quot;,
&quot;banner&quot;: &quot;/profile/upload/2025/01/27/banner.jpg&quot;,
&quot;poster&quot;: &quot;/profile/upload/2025/01/27/poster.jpg&quot;,
&quot;announceStart&quot;: &quot;2025-06-01&quot;,
&quot;announceEnd&quot;: &quot;2025-06-15&quot;,
&quot;state&quot;: 1,
&quot;isTop&quot;: 0,
&quot;matchState&quot;: 2,
&quot;createTime&quot;: &quot;2025-01-27 10:00:00&quot;
}
],
&quot;total&quot;: 1
}</code></pre>
<h2>成功返回字段说明（节选）</h2>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>integer</td>
<td>状态码，200为成功</td>
</tr>
<tr>
<td>msg</td>
<td>string</td>
<td>提示信息</td>
</tr>
<tr>
<td>list[].eventId</td>
<td>long</td>
<td>赛事ID</td>
</tr>
<tr>
<td>list[].eventName</td>
<td>string</td>
<td>赛事名称</td>
</tr>
<tr>
<td>list[].province</td>
<td>string</td>
<td>省份</td>
</tr>
<tr>
<td>list[].city</td>
<td>string</td>
<td>城市</td>
</tr>
<tr>
<td>list[].banner</td>
<td>string</td>
<td>顶部横幅图（如有）</td>
</tr>
<tr>
<td>list[].poster</td>
<td>string</td>
<td>海报图（如有）</td>
</tr>
<tr>
<td>list[].announceStart</td>
<td>string</td>
<td>公示开始日期 yyyy-MM-dd</td>
</tr>
<tr>
<td>list[].announceEnd</td>
<td>string</td>
<td>公示结束日期 yyyy-MM-dd</td>
</tr>
<tr>
<td>list[].state</td>
<td>integer</td>
<td>公示状态：0未公示 1已公示</td>
</tr>
<tr>
<td>list[].isTop</td>
<td>integer</td>
<td>是否置顶：0否 1是</td>
</tr>
<tr>
<td>list[].matchState</td>
<td>integer</td>
<td>赛事进度：0未开始 1即将开始 2报名中 3进行中 4已完成 5已取消</td>
</tr>
<tr>
<td>total</td>
<td>integer</td>
<td>结果总数</td>
</tr>
</tbody>
</table>