云上指挥


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>客户端认证请求头,请求头对应的值为 &quot;Basic c3dvcmQ6c3dvcmRfc2VjcmV0&quot;,其中&quot;c3dvcmQ6c3dvcmRfc2VjcmV0&quot;为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的拼接并以空格隔开,即&quot;{token_type} {access_token}&quot;</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">{ &amp;quot;days&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;disposeExplain&amp;quot;: &amp;quot;处置说明&amp;quot;, &amp;quot;eventDescribe&amp;quot;: &amp;quot;指挥室描述&amp;quot;, &amp;quot;files&amp;quot;: [ { &amp;quot;fileName&amp;quot;: &amp;quot;文件名称11&amp;quot;, &amp;quot;fileUrl&amp;quot;: &amp;quot;http://xxx&amp;quot; }, { &amp;quot;fileName&amp;quot;: &amp;quot;文件名称22&amp;quot;, &amp;quot;fileUrl&amp;quot;: &amp;quot;http://222&amp;quot; } ], &amp;quot;members&amp;quot;: [ { &amp;quot;externalUserId&amp;quot;: &amp;quot;8xxx4&amp;quot;, &amp;quot;sort&amp;quot;: 1, &amp;quot;userName&amp;quot;: &amp;quot;&amp;quot; }, { &amp;quot;externalUserId&amp;quot;: &amp;quot;8xxx6&amp;quot;, &amp;quot;sort&amp;quot;: 2, &amp;quot;userName&amp;quot;: &amp;quot;&amp;quot; } ], &amp;quot;name&amp;quot;: &amp;quot;指挥室名称&amp;quot;, &amp;quot;origin&amp;quot;: 1, &amp;quot;tags&amp;quot;: &amp;quot;1,2&amp;quot;, &amp;quot;area&amp;quot;: &amp;quot;浙江省&amp;quot;, &amp;quot;type&amp;quot;: &amp;quot;1&amp;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">{     &amp;quot;code&amp;quot;: 200,     &amp;quot;success&amp;quot;: true,     &amp;quot;data&amp;quot;: {         &amp;quot;code&amp;quot;: &amp;quot;202305160002&amp;quot;,         &amp;quot;url&amp;quot;: &amp;quot;http://114.55.234.176:8174/?roomId=1658298698004242434&amp;quot;,         &amp;quot;showUrl&amp;quot;: &amp;quot;http://114.55.234.176:8174/?roomId=1658298698004242434&amp;quot;     },     &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot; }</code></pre>

页面列表

ITEM_HTML