笆林中控APP


我的所有音效

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>我的所有音效</li> </ul> <h5>请求URL</h5> <ul> <li> <p><code>/api/v1/voice/all</code></p> <pre><code class="language-css">请求头中需带上TokenValue字段,传参接收到的token值,用于用户验证</code></pre> </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 style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">jsonstr</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求字符串</td> </tr> <tr> <td style="text-align: left;">token</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>token密钥</td> </tr> </tbody> </table> <table> <thead> <tr> <th style="text-align: left;">jsonstr参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">user_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户ID</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code> { &amp;quot;state&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;msg&amp;quot;: &amp;quot;获取成功&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;id&amp;quot;: 76, &amp;quot;voice_name&amp;quot;: &amp;quot;欢迎语音&amp;quot;, &amp;quot;voice_image&amp;quot;: &amp;quot;http://file.qijiniu.com/voice/202403/202403204102606044.jpg&amp;quot;, &amp;quot;voice_url&amp;quot;: &amp;quot;http://file.qijiniu.com/voice/202403/202403043102611097.mp3&amp;quot;, &amp;quot;voice_user&amp;quot;: 0, &amp;quot;voice_order&amp;quot;: 1, &amp;quot;voice_status&amp;quot;: 1, }, { &amp;quot;id&amp;quot;: 76, &amp;quot;voice_name&amp;quot;: &amp;quot;欢迎语音&amp;quot;, &amp;quot;voice_image&amp;quot;: &amp;quot;http://file.qijiniu.com/voice/202403/202403204102606044.jpg&amp;quot;, &amp;quot;voice_url&amp;quot;: &amp;quot;http://file.qijiniu.com/voice/202403/202403043102611097.mp3&amp;quot;, &amp;quot;voice_user&amp;quot;: 0, &amp;quot;voice_order&amp;quot;: 1, &amp;quot;voice_status&amp;quot;: 1, }, { &amp;quot;id&amp;quot;: 76, &amp;quot;voice_name&amp;quot;: &amp;quot;欢迎语音&amp;quot;, &amp;quot;voice_image&amp;quot;: &amp;quot;http://file.qijiniu.com/voice/202403/202403204102606044.jpg&amp;quot;, &amp;quot;voice_url&amp;quot;: &amp;quot;http://file.qijiniu.com/voice/202403/202403043102611097.mp3&amp;quot;, &amp;quot;voice_user&amp;quot;: 0, &amp;quot;voice_order&amp;quot;: 1, &amp;quot;voice_status&amp;quot;: 1, } }</code></pre> <h5>失败返回示例</h5> <pre><code> { &amp;quot;state&amp;quot;: &amp;quot;-999&amp;quot;, &amp;quot;msg&amp;quot;: &amp;quot;拒绝访问:你没有权限&amp;quot;, &amp;quot;data&amp;quot;: &amp;quot;&amp;quot; }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">state</td> <td style="text-align: left;">string</td> <td>状态 1为成功,其他为失败</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>接口返回信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">string</td> <td>信息</td> </tr> </tbody> </table> <table> <thead> <tr> <th style="text-align: left;">data中的参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">int</td> <td>音效id</td> </tr> <tr> <td style="text-align: left;">voice_name</td> <td style="text-align: left;">int</td> <td>语音名称</td> </tr> <tr> <td style="text-align: left;">voice_image</td> <td style="text-align: left;">string</td> <td>语音图标</td> </tr> <tr> <td style="text-align: left;">voice_url</td> <td style="text-align: left;">string</td> <td>语音文件地址</td> </tr> <tr> <td style="text-align: left;">voice_user</td> <td style="text-align: left;">string</td> <td>所属用户 0为系统,其他为用户ID</td> </tr> <tr> <td style="text-align: left;">voice_order</td> <td style="text-align: left;">string</td> <td>排序</td> </tr> <tr> <td style="text-align: left;">voice_status</td> <td style="text-align: left;">string</td> <td>有效性 0无效 1有效</td> </tr> </tbody> </table> <h5>错误代码</h5> <table> <thead> <tr> <th style="text-align: left;">代码名称</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">string</td> <td>成功</td> </tr> <tr> <td style="text-align: left;">-1</td> <td style="text-align: left;">string</td> <td>参数有误</td> </tr> <tr> <td style="text-align: left;">-2</td> <td style="text-align: left;">string</td> <td>无相关数据</td> </tr> <tr> <td style="text-align: left;">-99</td> <td style="text-align: left;">string</td> <td>异常</td> </tr> <tr> <td style="text-align: left;">-999</td> <td style="text-align: left;">string</td> <td>拒绝访问:你没有权限</td> </tr> <tr> <td style="text-align: left;">-9999</td> <td style="text-align: left;">string</td> <td>token验证失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML