篮球协会小程序接口文档


申请转让球队负责人

<h5>简要描述</h5> <ul> <li>申请转让球队负责人,向新负责人发送审批</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/approval/team/manager-transfer-apply</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST</li> </ul> <h5>请求体参数</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;">teamId</td> <td style="text-align: left;">101</td> <td>是</td> <td style="text-align: left;">Long</td> <td style="text-align: left;">球队ID</td> </tr> <tr> <td style="text-align: left;">currentManagerId</td> <td style="text-align: left;">456</td> <td>是</td> <td style="text-align: left;">Long</td> <td style="text-align: left;">当前负责人用户ID</td> </tr> <tr> <td style="text-align: left;">currentManagerName</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;">newManagerId</td> <td style="text-align: left;">789</td> <td>是</td> <td style="text-align: left;">Long</td> <td style="text-align: left;">新负责人用户ID</td> </tr> <tr> <td style="text-align: left;">newManagerName</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;">newManagerPhone</td> <td style="text-align: left;">13800138000</td> <td>是</td> <td style="text-align: left;">String</td> <td style="text-align: left;">新负责人联系方式</td> </tr> <tr> <td style="text-align: left;">transferReason</td> <td style="text-align: left;">个人原因需要转让</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;message&amp;quot;: &amp;quot;转让申请已发送给新负责人&amp;quot;,         &amp;quot;data&amp;quot;: {             &amp;quot;approvalId&amp;quot;: 123,             &amp;quot;transferId&amp;quot;: 456         }     } }</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.message</td> <td style="text-align: left;">string</td> <td style="text-align: left;">操作结果消息</td> </tr> <tr> <td style="text-align: left;">data.data.approvalId</td> <td style="text-align: left;">long</td> <td style="text-align: left;">审批ID(所有审批的表ID)</td> </tr> <tr> <td style="text-align: left;">data.data.transferId</td> <td style="text-align: left;">long</td> <td style="text-align: left;">转让申请ID(具体审批表ID)</td> </tr> </tbody> </table> <h5>使用说明</h5> <ul> <li>此接口用于申请转让球队负责人</li> <li>转让申请会发送给新负责人进行审批</li> <li>新负责人需要接受或拒绝转让申请</li> <li>只有当前负责人才能发起转让申请</li> </ul> <h5>注意事项</h5> <ul> <li>teamId必须是有效的球队ID</li> <li>currentManagerId必须是当前球队的负责人</li> <li>newManagerId必须是系统中存在的用户</li> <li>newManagerPhone必须是有效的联系方式</li> <li>transferReason不能为空</li> <li>转让申请创建后,新负责人会收到审批通知</li> <li>时间格式:YYYY-MM-DD HH:mm:ss</li> </ul> <h5>相关接口</h5> <ul> <li><a href="18.获取转让申请列表.md">获取转让申请列表</a> - 查看转让申请状态</li> <li><a href="13.审批操作.md">审批操作</a> - 新负责人处理转让申请</li> </ul>

页面列表

ITEM_HTML