电子围栏列表
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>电子围栏列表
<pre><code class="language-css">请求头中需带上TokenValue字段，传参接收到的token值,用于用户验证</code></pre></li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/v1/fence/list</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 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>
<tr>
<td style="text-align: left;">bike_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备编号</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第多少页</td>
</tr>
<tr>
<td style="text-align: left;">limit</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>每页多少条</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;1&quot;,
&quot;msg&quot;: &quot;获取成功&quot;,
&quot;data&quot;: [{
&quot;id&quot;: 880,
&quot;user_id&quot;: 100,
&quot;bike_id&quot;: &quot;SN1256369871&quot;,
&quot;fence_name&quot;: &quot;中科傲科产业园&quot;,
&quot;fence_location&quot;: &quot;广东省东莞市茶山镇站前路2号&quot;,
&quot;fence_range&quot;: 10,
&quot;fence_lng&quot;: &quot;23.669653655252&quot;,
&quot;fence_lat&quot;: &quot;180.366263696552&quot;,
&quot;fence_status&quot;: 1,
}
]
}</code></pre>
<h5>失败返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;-999&quot;,
&quot;msg&quot;: &quot;拒绝访问：你没有权限&quot;,
&quot;data&quot;: &quot;&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;">user_id</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">bike_id</td>
<td style="text-align: left;">string</td>
<td>设备编号</td>
</tr>
<tr>
<td style="text-align: left;">fence_name</td>
<td style="text-align: left;">string</td>
<td>围栏名称</td>
</tr>
<tr>
<td style="text-align: left;">fence_location</td>
<td style="text-align: left;">string</td>
<td>围栏位置</td>
</tr>
<tr>
<td style="text-align: left;">fence_range</td>
<td style="text-align: left;">int</td>
<td>围栏范围（KM）</td>
</tr>
<tr>
<td style="text-align: left;">fence_lng</td>
<td style="text-align: left;">string</td>
<td>围栏经度</td>
</tr>
<tr>
<td style="text-align: left;">fence_lat</td>
<td style="text-align: left;">string</td>
<td>围栏纬度</td>
</tr>
<tr>
<td style="text-align: left;">fence_status</td>
<td style="text-align: left;">int</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;">-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>