篮球协会小程序接口文档


获取场馆/约战列表

<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">{   &amp;quot;error_code&amp;quot;: 0,   &amp;quot;data&amp;quot;: {     &amp;quot;list&amp;quot;: [       {         &amp;quot;id&amp;quot;: 1,         &amp;quot;name&amp;quot;: &amp;quot;城市运动中心篮球馆&amp;quot;,         &amp;quot;city&amp;quot;: &amp;quot;北京市朝阳区&amp;quot;,         &amp;quot;address&amp;quot;: &amp;quot;朝阳区体育中心3号楼&amp;quot;,         &amp;quot;venue_field&amp;quot;: &amp;quot;一号场&amp;quot;,         &amp;quot;connect_person&amp;quot;: &amp;quot;郑队长&amp;quot;,         &amp;quot;connect_phone&amp;quot;: &amp;quot;010-87654321&amp;quot;,         &amp;quot;time&amp;quot;: &amp;quot;14:00-15:00&amp;quot;,         &amp;quot;teamA_last&amp;quot;: 3,         &amp;quot;teamB_last&amp;quot;: 3,         &amp;quot;cover_photo&amp;quot;: &amp;quot;/profile/upload/2025/08/14/5e1ae0a6-703a-11f0-af1f-2601d5e31493_00000_raw_20250814154937A001.jpeg&amp;quot;       }     ],     &amp;quot;total&amp;quot;: 100,     &amp;quot;page&amp;quot;: 1,     &amp;quot;pageSize&amp;quot;: 10   } }</code></pre> <p>type==1</p> <pre><code class="language-json">{   &amp;quot;error_code&amp;quot;: 0,   &amp;quot;data&amp;quot;: {     &amp;quot;list&amp;quot;: [       {         &amp;quot;id&amp;quot;: 1,         &amp;quot;name&amp;quot;: &amp;quot;城市运动中心篮球馆&amp;quot;,         &amp;quot;city&amp;quot;: &amp;quot;北京市朝阳区&amp;quot;,         &amp;quot;venue_field&amp;quot;: &amp;quot;一号场&amp;quot;,         &amp;quot;date&amp;quot;: &amp;quot;2019-07-01&amp;quot;,         &amp;quot;time&amp;quot;: &amp;quot;14:00-15:00&amp;quot;,         &amp;quot;status&amp;quot;: &amp;quot;进行中&amp;quot;,         &amp;quot;cover_photo&amp;quot;: &amp;quot;/profile/upload/2025/08/14/5e1ae0a6-703a-11f0-af1f-2601d5e31493_00000_raw_20250814154937A001.jpeg&amp;quot;       }     ],     &amp;quot;total&amp;quot;: 100,     &amp;quot;page&amp;quot;: 1,     &amp;quot;pageSize&amp;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>

页面列表

ITEM_HTML