设备上报
<h4>简要描述</h4>
<ul>
<li>设备上报</li>
</ul>
<h4>请求URL</h4>
<ul>
<li><code>http://&lt;service&gt;/api/device/report</code></li>
</ul>
<h4>请求方式</h4>
<ul>
<li>POST</li>
</ul>
<h4>请求示例</h4>
<pre><code> {
&quot;deviceId&quot;: &quot;SZ3127197000002&quot;,
&quot;imei&quot;: &quot;868777059994610&quot;,
&quot;iccid&quot;: &quot;89860116831014024277&quot;,
&quot;network&quot;: {
&quot;mcc&quot;: 460,
&quot;mnc&quot;: 1,
&quot;lac&quot;: 23836,
&quot;cid&quot;: 186506775,
&quot;signal&quot;: 66
},
&quot;wlan&quot;: {
&quot;mac&quot;: &quot;E8-49-43-01-53-7B&quot;,
&quot;ssid&quot;: &quot;XP-UFI_537B&quot;,
&quot;key&quot;: &quot;MTIzNDU2Nzg=&quot;,
&quot;status&quot;: 1
},
&quot;slotCurr&quot;: 0,
&quot;slotNum&quot;: 0,
&quot;connNum&quot;: 0,
&quot;lastTs&quot;: 25,
&quot;monthTs&quot;: 94
}</code></pre>
<h4>请求参数说明</h4>
<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;">accessToken</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>接入token</td>
</tr>
<tr>
<td style="text-align: left;">deviceId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备ID</td>
</tr>
<tr>
<td style="text-align: left;">imei</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备IMEI</td>
</tr>
<tr>
<td style="text-align: left;">iccid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>SIM 卡ICCID</td>
</tr>
<tr>
<td style="text-align: left;">network</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>4G网络信息</td>
</tr>
<tr>
<td style="text-align: left;">network.mcc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number</td>
<td>国家代码，460：中国</td>
</tr>
<tr>
<td style="text-align: left;">network.mnc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number</td>
<td>网络类型</td>
</tr>
<tr>
<td style="text-align: left;">network.lac</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number</td>
<td>位置区域码</td>
</tr>
<tr>
<td style="text-align: left;">network.cid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number</td>
<td>Cellid 基站号</td>
</tr>
<tr>
<td style="text-align: left;">network.signal</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number</td>
<td>信号强度指示</td>
</tr>
<tr>
<td style="text-align: left;">wlan</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>WiFi信息</td>
</tr>
<tr>
<td style="text-align: left;">wlan.mac</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>WiFi Mac地址，格式A1-B2-C3-D4-E5-F6</td>
</tr>
<tr>
<td style="text-align: left;">wlan.ssid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>WiFi 名称，UTF-8 编码</td>
</tr>
<tr>
<td style="text-align: left;">wlan.key</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>WiFi 密码，Base64 编码</td>
</tr>
<tr>
<td style="text-align: left;">wlan.status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>WiFi 状态，0：关闭，1：打开</td>
</tr>
<tr>
<td style="text-align: left;">battery</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>电池信息</td>
</tr>
<tr>
<td style="text-align: left;">battery.status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>电池状态，0：无电池，1：放电中，2：充电中</td>
</tr>
<tr>
<td style="text-align: left;">battery.level</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>电池电量，百分比</td>
</tr>
<tr>
<td style="text-align: left;">slotCurr</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>当前使用的卡槽号，0 开始</td>
</tr>
<tr>
<td style="text-align: left;">slotNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>SIM 卡槽总数</td>
</tr>
<tr>
<td style="text-align: left;">connNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>客户连接数</td>
</tr>
<tr>
<td style="text-align: left;">lastTs</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>上报间隔使用流量，单位：KB</td>
</tr>
<tr>
<td style="text-align: left;">monthTs</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>本月使用总流量，单位：KB</td>
</tr>
<tr>
<td style="text-align: left;">dataLimit</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>当前限速，单位：Kbps</td>
</tr>
<tr>
<td style="text-align: left;">deviceKey</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>设备webui登陆密码，Base64 编码</td>
</tr>
<tr>
<td style="text-align: left;">nextReport</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>下次上报间隔，单位：秒</td>
</tr>
</tbody>
</table>
<h4>返回示例（单指令格式）</h4>
<pre><code> {
&quot;cmdName&quot;: &quot;switch&quot;,
&quot;cmdParam&quot;: {
&quot;slot&quot;: 1
}
}</code></pre>
<h4>返回示例（多指令格式）</h4>
<pre><code> {
&quot;cmds&quot;: [
{
&quot;cmdName&quot;: &quot;setwifi&quot;,
&quot;cmdParam&quot;: {
&quot;ssid&quot;: &quot;testName&quot;,
&quot;key&quot;: &quot;1234567800&quot;
}
},
{
&quot;cmdName&quot;: &quot;setdevice&quot;,
&quot;cmdParam&quot;: {
&quot;key&quot;: &quot;87654321&quot;
}
}
]
}</code></pre>
<h4>返回参数说明</h4>
<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;">cmdName</td>
<td style="text-align: left;">string</td>
<td>下发指令名称</td>
</tr>
<tr>
<td style="text-align: left;">cmdParam</td>
<td style="text-align: left;">object</td>
<td>下发指令参数</td>
</tr>
</tbody>
</table>
<h4>下发指令说明</h4>
<ul>
<li>
<h6>reboot 指令，功能：重启设备</h6>
<p>无参数</p>
</li>
<li>
<h6>restore 指令，功能：复位出厂</h6>
<p>无参数</p>
</li>
<li>
<h6>update 指令，功能：FOTA升级</h6>
</li>
</ul>
<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;">cmdParam.url</td>
<td style="text-align: left;">string</td>
<td>版本地址</td>
</tr>
</tbody>
</table>
<ul>
<li>
<h6>switch 指令，功能：切卡</h6>
</li>
</ul>
<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;">cmdParam.slot</td>
<td style="text-align: left;">number</td>
<td>卡槽号，0 开始</td>
</tr>
<tr>
<td style="text-align: left;">cmdParam.mode</td>
<td style="text-align: left;">number</td>
<td>切卡模式，0:硬切卡, 1:智能切卡</td>
</tr>
</tbody>
</table>
<ul>
<li>
<h6>setint 指令，功能：设置上报间隔</h6>
</li>
</ul>
<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;">cmdParam.timer</td>
<td style="text-align: left;">number</td>
<td>时间间隔，单位：秒</td>
</tr>
</tbody>
</table>
<ul>
<li>
<h6>setlimit 指令，功能：限速</h6>
</li>
</ul>
<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;">cmdParam.speed</td>
<td style="text-align: left;">number</td>
<td>速度，单位：Kbps</td>
</tr>
</tbody>
</table>
<ul>
<li>
<h6>setnet 指令，功能：设置网络模式</h6>
</li>
</ul>
<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;">cmdParam.mode</td>
<td style="text-align: left;">number</td>
<td>0：关闭数据转发，1：打开数据转发</td>
</tr>
</tbody>
</table>
<ul>
<li>
<h6>setwifi 指令，功能：设置WiFi参数</h6>
</li>
</ul>
<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;">cmdParam.ssid</td>
<td style="text-align: left;">string</td>
<td>WiFi 名称，UTF-8 编码</td>
</tr>
<tr>
<td style="text-align: left;">cmdParam.key</td>
<td style="text-align: left;">string</td>
<td>WiFi 密码</td>
</tr>
<tr>
<td style="text-align: left;">cmdParam.status</td>
<td style="text-align: left;">number</td>
<td>0：关闭，1：打开</td>
</tr>
</tbody>
</table>
<ul>
<li>
<h6>setdevice 指令，功能：设置设备参数</h6>
</li>
</ul>
<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;">cmdParam.key</td>
<td style="text-align: left;">string</td>
<td>设备webui 登陆密码</td>
</tr>
</tbody>
</table>
<h4>备注</h4>
<ul>
<li>如果设备支持WiFi，上报有WiFi信息</li>
<li>如果设备支持电池，上报有电池信息</li>
<li>返回参数可以为空、单指令格式、多指令格式</li>
</ul>