鱼类查询单条信息
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>查询单条鱼类信息接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://localhost:83/findOne</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </li>
</ul>
<h5>headers参数</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;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户登录后的唯一凭证 token</td>
</tr>
</tbody>
</table>
<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;">_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>{
"code": "00000",
"msg": "ok",
"data": {
"_id": "62b44edfcba2b08de08d0047",//id
"name": "小丑鱼",//名字
"type": "海水鱼",//种类
"describe": "长得好看",//介绍
"__v": 0
}
}</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;">code</td>
<td style="text-align: left;">int</td>
<td>返回状态码00000表示成功</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;">object</td>
<td>查询的单条数据</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;">00001</td>
<td style="text-align: left;">int</td>
<td>缺少token</td>
</tr>
<tr>
<td style="text-align: left;">00002</td>
<td style="text-align: left;">int</td>
<td>token不合法或者无效</td>
</tr>
<tr>
<td style="text-align: left;">00003</td>
<td style="text-align: left;">int</td>
<td>缺少签名</td>
</tr>
<tr>
<td style="text-align: left;">00004</td>
<td style="text-align: left;">int</td>
<td>token签名时间大于当前时间,不合法</td>
</tr>
<tr>
<td style="text-align: left;">00005</td>
<td style="text-align: left;">int</td>
<td>token签名时间过期</td>
</tr>
<tr>
<td style="text-align: left;">00006</td>
<td style="text-align: left;">int</td>
<td>该时间之前不接受处理该token</td>
</tr>
<tr>
<td style="text-align: left;">00007</td>
<td style="text-align: left;">int</td>
<td>唯一标识出错</td>
</tr>
<tr>
<td style="text-align: left;">00008</td>
<td style="text-align: left;">int</td>
<td>查询失败</td>
</tr>
</tbody>
</table>