篮球协会小程序接口文档


获取球队列表

<h5>简要描述</h5> <ul> <li>获取球队列表,支持按名称和状态筛选</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/team/list</code></li> </ul> <h5>请求方式</h5> <ul> <li>GET</li> </ul> <h5>请求Query参数</h5> <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;">teamName</td> <td style="text-align: left;">篮球队</td> <td>否</td> <td style="text-align: left;">String</td> <td style="text-align: left;">球队名称(模糊搜索)</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">1</td> <td>否</td> <td style="text-align: left;">String</td> <td style="text-align: left;">球队状态</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code class="language-json">{     &amp;quot;code&amp;quot;: 200,     &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;,     &amp;quot;data&amp;quot;: {         &amp;quot;list&amp;quot;: [             {                 &amp;quot;teamId&amp;quot;: 1,                 &amp;quot;teamName&amp;quot;: &amp;quot;篮球队A&amp;quot;,                 &amp;quot;status&amp;quot;: &amp;quot;1&amp;quot;,                 &amp;quot;memberNum&amp;quot;: 15,                 &amp;quot;leaderName&amp;quot;: &amp;quot;张三&amp;quot;,                 &amp;quot;leaderPhone&amp;quot;: &amp;quot;13800138000&amp;quot;,                 &amp;quot;headCoachName&amp;quot;: &amp;quot;王教练&amp;quot;,                 &amp;quot;headCoachPhone&amp;quot;: &amp;quot;13900139000&amp;quot;,                 &amp;quot;province&amp;quot;: &amp;quot;北京市&amp;quot;,                 &amp;quot;city&amp;quot;: &amp;quot;北京市&amp;quot;,                 &amp;quot;address&amp;quot;: &amp;quot;详细地址&amp;quot;,                 &amp;quot;teamLogo&amp;quot;: &amp;quot;/profile/upload/2025/01/27/team_logo.jpg&amp;quot;             }         ],         &amp;quot;total&amp;quot;: 1     } }</code></pre> <h5>成功返回示例的参数说明</h5> <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;">响应状态码</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.list</td> <td style="text-align: left;">array</td> <td style="text-align: left;">球队列表</td> </tr> <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.status</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.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.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.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.total</td> <td style="text-align: left;">integer</td> <td style="text-align: left;">球队总数</td> </tr> </tbody> </table>

页面列表

ITEM_HTML