3.1 创建指挥室
<h2>3.1 创建指挥室</h2>
<h5>简要描述</h5>
<ul>
<li>第三方系统通过接口创建一个指挥室</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>{host}/api/openapi/cr/create</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST(HTTP) application/json</li>
</ul>
<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;">Authorization</td>
<td style="text-align: left;">String</td>
<td>客户端认证请求头,请求头对应的值为 "Basic c3dvcmQ6c3dvcmRfc2VjcmV0",其中"c3dvcmQ6c3dvcmRfc2VjcmV0"为clientId:clientSecret串转换为的base64编码</td>
</tr>
<tr>
<td style="text-align: left;">Blade-Auth</td>
<td style="text-align: left;">String</td>
<td>令牌认证请求头,请求头对应的值为调用 /oauth/token 接口返回的参数 token_type 和 access_token的拼接并以空格隔开,即"{token_type} {access_token}"</td>
</tr>
</tbody>
</table>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=add00ea8a054096182c8d1edad099c32" alt="" /></p>
<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;">name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>指挥室名称</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>指挥室类型</td>
</tr>
<tr>
<td style="text-align: left;">area</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>属地(中文)</td>
</tr>
<tr>
<td style="text-align: left;">origin</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>来源,详见数据字典</td>
</tr>
<tr>
<td style="text-align: left;">tags</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>标签 (多个用逗号隔开,注:一个标签不需要逗号)</td>
</tr>
<tr>
<td style="text-align: left;">eventDescribe</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>指挥室描述</td>
</tr>
<tr>
<td style="text-align: left;">disposeExplain</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>处置说明</td>
</tr>
<tr>
<td style="text-align: left;">days</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>时限</td>
</tr>
<tr>
<td style="text-align: left;">createExternalUserId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>发起人外部唯一用户id</td>
</tr>
<tr>
<td style="text-align: left;">createUserName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>发起人姓名</td>
</tr>
<tr>
<td style="text-align: left;">files</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List</td>
<td>文件</td>
</tr>
<tr>
<td style="text-align: left;">- fileName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>文件名称</td>
</tr>
<tr>
<td style="text-align: left;">- fileUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>文件路径</td>
</tr>
<tr>
<td style="text-align: left;">members</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List</td>
<td>成员集合</td>
</tr>
<tr>
<td style="text-align: left;">- externalUserId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>外部唯一用户id</td>
</tr>
<tr>
<td style="text-align: left;">- userName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>用户姓名</td>
</tr>
<tr>
<td style="text-align: left;">- sort</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>排序</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-json">{
&quot;days&quot;: &quot;1&quot;,
&quot;disposeExplain&quot;: &quot;处置说明&quot;,
&quot;eventDescribe&quot;: &quot;指挥室描述&quot;,
&quot;files&quot;: [
{
&quot;fileName&quot;: &quot;文件名称11&quot;,
&quot;fileUrl&quot;: &quot;http://xxx&quot;
},
{
&quot;fileName&quot;: &quot;文件名称22&quot;,
&quot;fileUrl&quot;: &quot;http://222&quot;
}
],
&quot;members&quot;: [
{
&quot;externalUserId&quot;: &quot;8xxx4&quot;,
&quot;sort&quot;: 1,
&quot;userName&quot;: &quot;&quot;
},
{
&quot;externalUserId&quot;: &quot;8xxx6&quot;,
&quot;sort&quot;: 2,
&quot;userName&quot;: &quot;&quot;
}
],
&quot;name&quot;: &quot;指挥室名称&quot;,
&quot;origin&quot;: 1,
&quot;tags&quot;: &quot;1,2&quot;,
&quot;area&quot;: &quot;浙江省&quot;,
&quot;type&quot;: &quot;1&quot;
}</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;">String</td>
<td>指挥室编号</td>
</tr>
<tr>
<td style="text-align: left;">url</td>
<td style="text-align: left;">String</td>
<td>指挥室入口url</td>
</tr>
<tr>
<td style="text-align: left;">showUrl</td>
<td style="text-align: left;">String</td>
<td>用于嵌入指挥大屏的url</td>
</tr>
</tbody>
</table>
<p><strong>响应示例</strong>:</p>
<pre><code class="language-javascript">{
&quot;code&quot;: 200,
&quot;success&quot;: true,
&quot;data&quot;: {
&quot;code&quot;: &quot;202305160002&quot;,
&quot;url&quot;: &quot;http://114.55.234.176:8174/?roomId=1658298698004242434&quot;,
&quot;showUrl&quot;: &quot;http://114.55.234.176:8174/?roomId=1658298698004242434&quot;
},
&quot;msg&quot;: &quot;操作成功&quot;
}</code></pre>