_site/addToGroup.html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
<meta name="keywords" content=" ">
<title>添加设备到分组 | Jekyll theme for documentation</title>
<link rel="stylesheet" href="css/syntax.css">

<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css">
<!--<link rel="stylesheet" type="text/css" href="css/bootstrap.min.css">-->
<link rel="stylesheet" href="css/modern-business.css">
<!-- Latest compiled and minified CSS -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
<link rel="stylesheet" href="css/customstyles.css">
<link rel="stylesheet" href="css/boxshadowproperties.css">
<!-- most color styles are extracted out to here -->
<link rel="stylesheet" href="css/theme-blue.css">

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js"></script>

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-cookie/1.4.1/jquery.cookie.min.js"></script>
<script src="js/jquery.navgoco.min.js"></script>


<!-- Latest compiled and minified JavaScript -->
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
<!-- Anchor.js -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js"></script>
<script src="js/toc.js"></script>
<script src="js/customscripts.js"></script>

<link rel="shortcut icon" href="images/favicon.ico">

<!-- HTML5 Shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
<![endif]-->
<link rel="alternate" type="application/rss+xml" title="" href="http://localhost:4000/feed.xml">

    <script>
        $(document).ready(function() {
            // Initialize navgoco with default options
            $("#mysidebar").navgoco({
                caretHtml: '',
                accordion: true,
                openClass: 'active', // open
                save: false, // leave false or nav highlighting doesn't work right
                cookie: {
                    name: 'navgoco',
                    expires: false,
                    path: '/'
                },
                slide: {
                    duration: 400,
                    easing: 'swing'
                }
            });

            $("#collapseAll").click(function(e) {
                e.preventDefault();
                $("#mysidebar").navgoco('toggle', false);
            });

            $("#expandAll").click(function(e) {
                e.preventDefault();
                $("#mysidebar").navgoco('toggle', true);
            });

        });

    </script>
    <script>
        $(function () {
            $('[data-toggle="tooltip"]').tooltip()
        })
    </script>
    <script>
        $(document).ready(function() {
            $("#tg-sb-link").click(function() {
                $("#tg-sb-sidebar").toggle();
                $("#tg-sb-content").toggleClass('col-md-9');
                $("#tg-sb-content").toggleClass('col-md-12');
                $("#tg-sb-icon").toggleClass('fa-toggle-on');
                $("#tg-sb-icon").toggleClass('fa-toggle-off');
            });
        });
    </script>
    

</head>
<body>
<!-- Navigation -->
<nav class="navbar navbar-inverse navbar-static-top">
    <div class="container topnavlinks">
        <div class="navbar-header">
            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
                <span class="sr-only">Toggle navigation</span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
            </button>
            <a class="fa fa-home fa-lg navbar-brand" href="index.html">&nbsp;<span class="projectTitle"> 酷宅开放平台</span></a>
        </div>
        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
            <ul class="nav navbar-nav navbar-right">
		<li style="line-height: 50px;">
		    <label><a href="index.html">中文</a></label>
		    <label><a href="platformOverview_en.html">English</a></label>
		</li>
                <li>
                    <!--start search-->
                    <div id="search-demo-container">
                        <input type="text" id="search-input" placeholder="search...">
                        <ul id="results-container"></ul>
                    </div>
                    <script src="js/jekyll-search.js" type="text/javascript"></script>
                    <script type="text/javascript">
                            SimpleJekyllSearch.init({
                                searchInput: document.getElementById('search-input'),
                                resultsContainer: document.getElementById('results-container'),
                                dataSource: 'search.json',
                                searchResultTemplate: '<li><a href="{url}" title="添加设备到分组">{title}</a></li>',
                    noResultsText: 'No results found.',
                            limit: 10,
                            fuzzy: true,
                    })
                    </script>
                    <!--end search-->
                </li>
            </ul>
        </div>
        </div>
        <!-- /.container -->
</nav>

<!-- Page Content -->
<div class="container">
  <div id="main">
    <!-- Content Row -->
    <div class="row">
        
        
            <!-- Sidebar Column -->
            <div class="col-md-3" id="tg-sb-sidebar">
                

<ul id="mysidebar" class="nav">
  <li class="sidebarTitle">酷宅开放平台 2.0</li>
  
  
  <li>
      
      <a href="platformOverview.html">平台概述</a>
      
      <ul>
          
      </ul>
   </li>
     
      
  <li>
      
      <a href="apiFee.html">API收费标准</a>
      
      <ul>
          
      </ul>
   </li>
     
      
  <li>
      
      <a href="#">开发文档</a>
      
      <ul>
          
          
          <li><a href="developerGuide.html">开发者指南</a></li>
          
          
          <li><a href="develop.html">准备开发环境</a></li>
          
          
          <li><a href="developer.html">成为开发者</a></li>
          
          
          <li><a href="application.html">创建第一个应用</a></li>
          
          
          <li><a href="instruction.html">开发通用说明</a></li>
          
          
          <li><a href="pair.html">配对过程</a></li>
          
          
          <li><a href="sdk.html">SDK</a></li>
          
          
      </ul>
   </li>
     
      
  <li>
      
      <a href="#">API中心</a>
      
      <ul>
          
          
          <li><a href="apiOverview.html">API总览</a></li>
          
          
          <li class="subfolders">
              <a href="#">区域功能</a>
              <ul>
                  
                  
                  <li><a href="region.html">查询当前区域</a></li>
                  
                  
              </ul>
          </li>
          
          
          <li class="subfolders">
              <a href="#">帐号管理功能</a>
              <ul>
                  
                  
                  <li><a href="code.html">验证码</a></li>
                  
                  
                  <li><a href="register.html">注册</a></li>
                  
                  
                  <li><a href="findpassword.html">找回密码</a></li>
                  
                  
                  <li><a href="updatePassword.html">修改密码</a></li>
                  
                  
                  <li><a href="login.html">登录</a></li>
                  
                  
                  <li><a href="token.html">token刷新</a></li>
                  
                  
              </ul>
          </li>
          
          
          <li class="subfolders">
              <a href="#">设备管理功能</a>
              <ul>
                  
                  
                  <li><a href="devices.html">设备列表</a></li>
                  
                  
                  <li><a href="device.html">单个设备查询</a></li>
                  
                  
                  <li><a href="addDevice.html">添加设备</a></li>
                  
                  
                  <li><a href="deleteDevice.html">删除设备</a></li>
                  
                  
                  <li><a href="updateDevice.html">修改设备名称</a></li>
                  
                  
                  <li><a href="addGsm.html">增加GSM设备</a></li>
                  
                  
                  <li><a href="addDeviceGroup.html">增加设备分组</a></li>
                  
                  
                  <li><a href="updateGroup.html">修改设备分组</a></li>
                  
                  
                  <li><a href="deleteGroup.html">删除设备分组</a></li>
                  
                  
                  <li class="active"><a href="addToGroup.html">添加设备到分组</a></li>
                  
                  
                  <li><a href="findGroup.html">查询设备分组</a></li>
                  
                  
              </ul>
          </li>
          
          
          <li class="subfolders">
              <a href="#">设备控制功能</a>
              <ul>
                  
                  
                  <li><a href="dispatch.html">分配服务</a></li>
                  
                  
                  <li><a href="handshake.html">握手</a></li>
                  
                  
                  <li><a href="online.html">设备上线/离线</a></li>
                  
                  
                  <li><a href="deviceStatus.html">更新/上报状态</a></li>
                  
                  
                  <li><a href="findStatus.html">设备状态查询</a></li>
                  
                  
                  <li><a href="share.html">分享</a></li>
                  
                  
                  <li><a href="shareUpdate.html">修改分享</a></li>
                  
                  
                  <li><a href="shareCancel.html">撤销分享</a></li>
                  
                  
                  <li><a href="deviceStatusHttp.html">查询设备状态</a></li>
                  
                  
                  <li><a href="updateStatusHttp.html">更新设备状态</a></li>
                  
                  
              </ul>
          </li>
          
          
      </ul>
   </li>
     
      
  <li>
      
      <a href="#">常见问题</a>
      
      <ul>
          
          
          <li><a href="faqOauth.html">认证</a></li>
          
          
          <li><a href="faqCode.html">验证码</a></li>
          
          
          <li><a href="faqAccount.html">帐号</a></li>
          
          
          <li><a href="faqDevice.html">设备</a></li>
          
          
      </ul>
   </li>
     
      
  <li>
      
      <a href="contactUs.html">联系我们</a>
      
      <ul>
          
      </ul>
   </li>
     
      
      <!-- if you aren't using the accordion, uncomment this block:
         <p class="external">
             <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
         </p>
         -->
</ul>

<!-- this highlights the active parent class in the navgoco sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
<script>$("li.active").parents('li').toggleClass("active");</script>

            </div>
            
        
        <!-- Content Column -->
        <div class="col-md-9" id="tg-sb-content">
            <div class="post-header">
   <h1 class="post-title-main">添加设备到分组</h1>
</div>


<div class="post-content">

   
<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
<script>
$( document ).ready(function() {
  // Handler for .ready() called.

$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });

/* this offset helps account for the space taken up by the floating toolbar. */
$('#toc').on('click', 'a', function() {
  var target = $(this.getAttribute('href'))
    , scroll_target = target.offset().top

  $(window).scrollTop(scroll_target - 10);
  return false
})
  
});
</script>

<div id="toc"></div>

    
   <p>给设备进行分组，支持设备在多个分组内。默认是新增分组，也可以选择覆盖分组。如果目标分组id为空，则表示把设备从分组中移出。</p>

<ul>
  <li>
    <p>正式环境URL: <code class="highlighter-rouge">https://cn(区域)-api.coolkit.cn:8080/api/group/addDevice</code></p>
  </li>
  <li>
    <p>测试环境URL: <code class="highlighter-rouge">https://testapi.coolkit.cn:8080/api/group/addDevice</code></p>
  </li>
  <li>
    <p>请求方法： POST</p>
  </li>
  <li>
    <p>请求参数：</p>
  </li>
</ul>

<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">deviceinfos</td>
      <td style="text-align: left">是</td>
      <td style="text-align: left">[device]</td>
      <td>设备数组</td>
    </tr>
  </tbody>
</table>

<ul>
  <li>device说明：</li>
</ul>

<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">source_id</td>
      <td style="text-align: left">是</td>
      <td style="text-align: left">String</td>
      <td>原分组id，可以为空””</td>
    </tr>
    <tr>
      <td style="text-align: left">target_id</td>
      <td style="text-align: left">是</td>
      <td style="text-align: left">String</td>
      <td>目标分组的id，可以为空””。为空“”则把设备从分组中移除</td>
    </tr>
    <tr>
      <td style="text-align: left">deviceid</td>
      <td style="text-align: left">是</td>
      <td style="text-align: left">String</td>
      <td>设备id</td>
    </tr>
    <tr>
      <td style="text-align: left">type</td>
      <td style="text-align: left">否</td>
      <td style="text-align: left">Int</td>
      <td>0:    新增分组（默认）  1：覆盖分组</td>
    </tr>
  </tbody>
</table>

<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>本接口支持多个不同分组的设备，移动到不同的分组，采用数组对象的方式实现，json例子：
[
   {
      "source_id":"分组1",
      "target_id":"分组2",
      "deviceid":"1000000b01",
      "type":0
   },
   {
      "source_id":"分组1",
      "target_id":"分组2",
      "deviceid":"1000000b02",
      "type":0
   },
   {
      "source_id":"分组3",
      "target_id":"分组2",
      "deviceid":"1000000b03",
      "type":1
   }
]
type字段说明：
比如设备1000000b01 原本有2个分组，在devices表字段如下：
"groups":["111","222"]          实际上分组id应该是36位uuid，这里为了清晰简化了
接口收到请求数据中，源分组id是111 ，目标分组id是333，

如果type=0，那么数据库结果就是：
"groups":["333","222"]     也就是说将原来的组111改成333，222保留

如果type=1 , 那么数据库结果就是：
"groups":["333"]   也就是说不管原来设备有几个分组，现在只保留最新这一个
</code></pre></div></div>

<p><strong>响应参数:</strong></p>

<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">error</td>
      <td style="text-align: left">是</td>
      <td style="text-align: left">Int</td>
      <td>错误码</td>
    </tr>
  </tbody>
</table>

<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>错误码
0:操作成功
400:参数错误
401:认证失败
500:服务器错误
</code></pre></div></div>


</div>

<hr class="shaded"/>

<footer>
            <div class="row">
                <div class="col-lg-12 footer">
               &copy;2019 深圳酷宅科技有限公司。 版权所有。 <br />
<span>最后更新时间:</span> 2019-03-20<br/>
<p><img src="images/coolkit.png" alt="CoolKit"/></p>
                </div>
            </div>
</footer>


        </div>
    <!-- /.row -->
</div>
<!-- /.container -->
</div>
<!-- /#main -->
    </div>

</body>
</html>