OpenAPI最佳实践（必看）
<h1>OpenAPI 最佳实践指南</h1>
<h2>🛠️ 前置准备</h2>
<ol>
<li>
<p><strong>拥有一个物联网云平台的登录账号</strong>
方式 1. 登录云平台申请体验账号
方式 2. 由你的上级账号在物联网云平台分配账号</p>
</li>
<li>
<p><strong>获取接入密钥</strong>
登录进入物联网云平台，点击右上角【我的】 -> 【开发者信息】，点击眼睛图标即可显示接口接入密匙
<strong>注意：该密匙唯一，拥有你账号的所有权限，请务必保管好防止泄露！！</strong></p>
</li>
<li><strong>使用接入密匙(accessId) [获取接入token](<a href="https://www.showdoc.com.cn/382341824968230/3590411886156336">https://www.showdoc.com.cn/382341824968230/3590411886156336</a> "换取接入token")访问OpenAPI接口</strong></li>
</ol>
<h2>📌 快速匹配您的场景</h2>
<p>> 根据您的业务需求选择对应路径，可直达配置指引</p>
<ul>
<li><strong>场景一：只在需要时获取设备的数据，可能要控制设备</strong><br />
→ <a href="#🚀 场景一：最小化数据接口接入">跳转至《最小化数据接口接入》</a></li>
<li><strong>场景二：我需要设备实时的报警或数据推送</strong><br />
→ [跳转至《数据推送》](<a href="https://www.showdoc.com.cn/382341824968230/5021335889176096">https://www.showdoc.com.cn/382341824968230/5021335889176096</a> "跳转至数据推送")</li>
<li>
<h2><strong>场景三：上述二者都需要，并且我在自己系统有业务管理的需求</strong><br />
→ [跳转至《OpenAPI列表》](<a href="https://www.showdoc.com.cn/382341824968230/3528263235526618">https://www.showdoc.com.cn/382341824968230/3528263235526618</a> "跳转至OpenAPI列表")，并结合场景一、二的引导文档</h2>
</li>
</ul>
<h2>🚀 场景一：最小化数据接口接入</h2>
<h3>步骤 1：[查看请求约定](<a href="https://www.showdoc.com.cn/382341824968230/2216802349292977">https://www.showdoc.com.cn/382341824968230/2216802349292977</a> "查看请求约定")</h3>
<h3>步骤 2：精准选择接口</h3>
<table>
<thead>
<tr>
<th>接口</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>[获取AccessToken](<a href="https://www.showdoc.com.cn/382341824968230/3590411886156336">https://www.showdoc.com.cn/382341824968230/3590411886156336</a> "文档")</td>
<td>无</td>
</tr>
<tr>
<td>[查询权限下具有的设备列表](<a href="https://www.showdoc.com.cn/382341824968230/3594321636446560">https://www.showdoc.com.cn/382341824968230/3594321636446560</a> "文档")</td>
<td>无</td>
</tr>
<tr>
<td>[获取设备实时数据](<a href="https://www.showdoc.com.cn/382341824968230/2217337700681456">https://www.showdoc.com.cn/382341824968230/2217337700681456</a> "文档")</td>
<td>无</td>
</tr>
<tr>
<td>[获取设备可控制的属性](<a href="https://www.showdoc.com.cn/382341824968230/3595091407649932">https://www.showdoc.com.cn/382341824968230/3595091407649932</a> "文档")</td>
<td>可选，如果需要控制设备</td>
</tr>
<tr>
<td>[设备控制/下发](<a href="https://www.showdoc.com.cn/382341824968230/2216799121381121">https://www.showdoc.com.cn/382341824968230/2216799121381121</a> "文档")</td>
<td>可选，如果需要控制设备</td>
</tr>
</tbody>
</table>