物联网平台 OTA 命令升级
<p>[TOC]</p>
<h3>接口简述</h3>
<ul>
<li>该升级接口仅适用于自己接入物联网平台（中国电信、中国移动）的客户使用</li>
<li>这里 OTA 升级，需要自己提供 OTA 升级包（如果没有，可向我司索取，需提供现有设备版本号，版本号设备里面可查询）</li>
<li>只有涉及到重大问题的时候，才建议使用 OTA 升级功能；其他时候，不建议使用</li>
<li>说明：这里的升级命令是针对<code>801，802，803</code>开头的命令内容，进行的升级操作</li>
</ul>
<h3>升级流程</h3>
<ol>
<li>锁端管理员进入菜单页面，选择“<code>系统管理</code>”-->“<code>系统升级</code>” 菜单，进行 OTA 数据申请</li>
<li>贵公司收到物联网平台上报的内容后，直接调用该接口</li>
<li>该接口返回物联网平台所需的相关命令数据（这里为单条或多条）</li>
<li>通过该接口返回的命令数据，直接自行下发物联网命令到自己锁端即可</li>
<li>持续进行2~4步操作，大约十几分钟，会提示升级成功；升级成功后，物联网平台也会返回 <code>804</code>数据</li>
</ol>
<h3>请求URL</h3>
<ul>
<li><code>commercial/device/ota</code></li>
</ul>
<h3>请求方式</h3>
<ul>
<li><code>PUT</code></li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>buttPlatformType</td>
<td>是</td>
<td>Integer</td>
<td>对接平台类型（0：中国电信；1：OneNET）</td>
</tr>
<tr>
<td>filePath</td>
<td>是</td>
<td>String</td>
<td>OTA 文件路径</td>
</tr>
<tr>
<td>content</td>
<td>是</td>
<td>String</td>
<td>命令上报内容</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>{
"buttPlatformType": 0,
"filePath": "https://prod-read.oss-cn-shanghai.aliyuncs.com/ota/YY_OC_SY1_NB701_000_210812.bin",
"content": "801"
}</code></pre>
<h3>返回参数（中国电信）</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>serviceId</td>
<td>是</td>
<td>String</td>
<td>服务 id</td>
</tr>
<tr>
<td>method</td>
<td>是</td>
<td>String</td>
<td>方法</td>
</tr>
<tr>
<td>paras</td>
<td>是</td>
<td>String</td>
<td>具体的命令内容</td>
</tr>
</tbody>
</table>
<h3>返回示例（中国电信）</h3>
<pre><code>{
"code": 0,
"message": "成功",
"data": [
{
"method": "otaDown",
"paras": {
"data": "801YY_OC_SY1_NB701_000_210812"
},
"serviceId": "ota"
}
]
}</code></pre>
<hr />
<h3>返回参数（OneNET）</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>obj_inst_id</td>
<td>是</td>
<td>String</td>
<td>对象实例 id</td>
</tr>
<tr>
<td>ds_id</td>
<td>是</td>
<td>String</td>
<td>ds id</td>
</tr>
<tr>
<td>val</td>
<td>是</td>
<td>String</td>
<td>具体的命令内容</td>
</tr>
</tbody>
</table>
<h3>返回示例（OneNET）</h3>
<pre><code>{
"code": 0,
"message": "成功",
"data": [
{
"val": "801YY_ON_SY1_NB700_000_200501",
"obj_inst_id": 13
}
]
}</code></pre>