VentilatorBind - API
<h1>1.呼吸机绑定API文档</h1>
<h2>1.1 接口概述 - 绑定呼吸机设备</h2>
<p>这个接口允许第三方制造商将他们的呼吸机设备和客户之间建立一种数据转发关系。具体来说:</p>
<ul>
<li><strong>主要用途</strong>:允许制造商从呼吸机设备中收集数据,建立直接数据传输通道。</li>
<li><strong>绑定过程</strong>:成功绑定后,制造商可以通过专门的数据接口接收呼吸机数据。</li>
<li><strong>居民数据</strong>:绑定时需同时绑定患者信息,使用系统唯一字段(如保险卡号)。患者信息必须提前在konsung系统录入。每位患者的数据独立处理。</li>
</ul>
<p>> <strong>安全考虑</strong>:</p>
<ul>
<li><strong>重要性</strong>:为了保护数据的安全性,所有通过这个接口的数据传输都必须进行加密。</li>
<li><strong>方法</strong>:使用AES加密方法对所有请求和响应进行加密和解密。</li>
<li><strong>更多信息</strong>:<code>请查阅我们提供的“安全加密指南”,了解具体的操作步骤和加密细节</code>。</li>
</ul>
<h2>1.2 请求网址</h2>
<ul>
<li><code>http://ip:port/openapi/third/ventilator/bind</code></li>
</ul>
<h2>1.3 请求方式</h2>
<ul>
<li>协议: HTTP</li>
<li>数据格式: JSON</li>
<li>请求方式: POST</li>
</ul>
<h2>1.4 请求参数</h2>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必需</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>appKey</td>
<td>string</td>
<td>是</td>
<td>客户的<code>appKey</code>。通过秘钥与时间戳进行<code>MD5</code>生成。<code>MD5(appSecret+time)</code></td>
</tr>
<tr>
<td>appSecret</td>
<td>string</td>
<td>否</td>
<td>客户的<code>appSecret</code>。由 Konsung 分配,用于与<code>time</code>结合进行安全加密。仅在需要额外安全验证时使用。</td>
</tr>
<tr>
<td>deviceCode</td>
<td>string</td>
<td>是</td>
<td>设备的唯一标识符,用于标识请求来源的具体机器设备。</td>
</tr>
<tr>
<td>cardType</td>
<td>string</td>
<td>是</td>
<td>患者绑定的卡类型(1:保险卡号)</td>
</tr>
<tr>
<td>idCardNumber</td>
<td>string</td>
<td>是</td>
<td>患者绑定的卡编号</td>
</tr>
<tr>
<td>time</td>
<td>string</td>
<td>是</td>
<td>请求的时间戳(13位),以毫秒为单位。用于验证请求的时效性。</td>
</tr>
</tbody>
</table>
<p><strong>获取<code>appKey</code>和<code>appSecret</code></strong>:</p>
<ul>
<li><code>appKey</code>和<code>appSecret</code>是进行接口对接的必要凭证,其中<code>appSecret</code>必须由 Konsung 提供。</li>
<li>客户在对接前需要向 Konsung 申请<code>appSecret</code>凭证。</li>
<li>一旦获取到这些凭证,客户应妥善保管,避免泄露。</li>
</ul>
<p><strong>说明</strong>:</p>
<ul>
<li><code>appKey</code>和<code>time</code>字段用于生成签名,确保请求的安全性。签名的生成方式是将<code>appKey</code>和<code>time</code>连接后进行 <code>MD5</code> 加密。</li>
<li>如果提供<code>appSecret</code>,它将用于进一步加强请求的安全验证。</li>
<li>请确保<code>time</code>参数的准确性,以避免请求因时间不同步而被拒绝。</li>
</ul>
<h3>1.4.1 请求示例</h3>
<pre><code class="language-json">{
&quot;appKey&quot;: &quot;39732751d56b62412c7c32dde47e96e3&quot;,
&quot;appSecret&quot;: &quot;123456&quot;,
&quot;deviceCode&quot;: &quot;YB202304140456&quot;,
&quot;cardType&quot;:&quot;1&quot;,
&quot;idCardNumber&quot;:&quot;37281927361223&quot;,
&quot;time&quot;: &quot;1691636986000&quot;
}</code></pre>
<h2>1.5 响应参数</h2>
<table>
<thead>
<tr>
<th>姓名</th>
<th>类型</th>
<th>必需的</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>string</td>
<td>是的</td>
<td>状态码</td>
</tr>
<tr>
<td>errorMessage</td>
<td>string</td>
<td>是的</td>
<td>错误信息</td>
</tr>
</tbody>
</table>
<h3>1.5.1 响应示例</h3>
<h4>成功</h4>
<pre><code class="language-json">{
&quot;code&quot;: &quot;000&quot;,
&quot;errorMessage&quot;: &quot;&quot;,
}</code></pre>
<h4>失败</h4>
<pre><code class="language-json">{
&quot;code&quot;: &quot;105&quot;,
&quot;errorMessage&quot;: &quot;sign签名不正确&quot;,
}</code></pre>
<h2>错误代码</h2>
<p>有关更多错误代码,请访问<a href="https://www.showdoc.com.cn/ksox/10713677634776839">错误代码说明。</a></p>
<h2>变更历史记录</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">改变日期</th>
<th style="text-align: left;">变更摘要</th>
<th style="text-align: left;">操作</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">-</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>