获取从机列表-设备-有人云

#### 简要描述

获取模板从机列表

#### 请求URL

https://openapi.mp.usr.cn/usrCloud/dev/slave/getTemplateSlaves

#### 请求方式

POST

#### 用户等级
:fa-check-square-o: 基础版 :fa-check-square-o: 企业版 :fa-check-square-o: 旗舰版

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用[获取详情](http://cloud.usr.cn/document/362.html "获取详情") )|
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| deviceTemplateId | 必选  | List  | Body | 设备的SN集合 |
| isNeedJson | 可选  | String  | Body | 是否查询协议规则 |
| pageNo | 可选  | Integer  | Body | 分页页号（ 从1开始 ） |
| pageSize | 可选  | Integer  | Body | 分页大小 |

#### 响应参数

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| data  | JSONObject  | 响应数据  |
| info  | String  | 提示消息  |
| status  | Integer  | 返回码  |

**响应数据（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| total  | Integer  | 变量总数量  |
| list  | JSONArray  | 变量信息数组  |
| pageNum  | Integer  | 页码  |
| pageSize  | Integer  | 每页大小 |
| size  | Integer  | 大小 |
| startRow  | Integer  | 起始行 |
| endRow  | Integer  | 结束行 |
| pages  | Integer  | 页面  |
| prePage  | Integer  | 前一页  |
| nextPage  | Integer  | 下一页  |
| isFirstPage  | Boolean  | 是否是第一页  |
| isLastPage  | Boolean  | 是否是最后一页  |
| hasPreviousPage  | Boolean  | 是否具有上一页  |
| hasNextPage  | Boolean  | 是否具有下一页  |
| navigatePages  | Integer  | 浏览页面  |
| navigatepageNums  | Array  | 浏览页码  |
| navigateFirstPage  | Integer  | 浏览第一页  |
| navigateLastPage  | Integer  | 浏览最后一页  |
| firstPage  | Integer  | 第一页  |
| lastPage  | Integer  | 最后一页  |

**响应数据（list）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| id  | Integer  | 自增id |
| userId  | Integer  | 用户id |
| deviceTemplateId  | Integer  | 设备模板id |
| slaveIndex  | String | 从机序号 |
| slaveName  | String  | 从机名称 |
| slaveAddr  | String  | 从机地址  |
| slaveIp  | String  | 从机IP |
| slavePort  | Integer  | 从机端口  |
| createDt | String |创建时间 |
| updateDt | String  | 修改时间  |
| creator | Integer  | 创建人 |
| updator  | Integer  | 修改人 |
| comIdx  | Integer  | 通讯号 只能从1-16  |
| relProtocolId  | Integer  | 关联协议id |
| weight | Integer  | 权重 |
| deviceTemplateProtocolGroupList | JSONObject  | 关联协议分组及详情 |

**响应数据（deviceTemplateProtocolGroupList）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| id  | Integer  | 自增id |
| pageNo | Integer | 页码  |
| pageSize | Integer | 每页大小 |
| title  | String | 标题  |
| titleEn | String  |英文标题 |
| sort | Integer  | 排序  |
| type | Integer  | 类型  |
| createDt | String |创建时间 |
| updateDt | String  | 修改时间  |
| creator | Integer  | 创建人 |
| updator  | Integer  | 修改人 |
| children  | JSONObject | 子节点  |
| groupOrProtocolType  | Integer  | 分组与产品协议类型  |

**响应数据（children）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| id  | Integer  | 自增id |
| pageNo | Integer | 页码  |
| pageSize | Integer | 每页大小 |
| name  | String | 从机名称  |
| snSeriesModel | String  |SN的系列编码 |
| parentId | Integer  | 父级  |
| parentIds | String  | 父级列表  |
| createDt | String |创建时间 |
| updateDt | String  | 修改时间  |
| creator | Integer  | 创建人 |
| updator  | Integer  | 修改人 |
| children  | JSONObject | 子节点  |
| sort  | Integer  | 排序  |
| relProtocolGroupId  | Integer  | 关联的协议分组ID  |
| slaveType  | Integer  | 从机类型 1串口 2网口  |
| datapointType  | Integer  | 数据点类型 1西门子1 2西门子2  |
| recommendContent  | String  | 提示语  |
| pollingMethod  | Integer  | 轮询方式 1边缘计算 2主动采集  |
| nameForDevice  | String  | 给设备用到的协议名称  |
| category  | Integer  | 分类(从属多个分类，使用逗号分割): 边缘计算(1)、云端轮询(2)、云端轮询-ModbusRTU(201)、云端轮询-ModbusTCP(202)  |
| brand  | Integer  | 品牌  |
| brandEn  | Integer  | 品牌英文  |
| encrypted  | Integer  | 是否加密（1：加密，0：不加密）  |
| groupOrProtocolType  | Integer  | 分组类型：协议分组(0)、产品分组(1)/产品协议类型：协议(0)、产品(1)  |
#### 返回码说明

| 返回码  | 说明  |
| ------------ | ------------ |
| 0  | 成功  |
| 5106 | 参数不完整  |
| 5004 | 权限不足  |

#### 请求示例

<pre>
POST https://openapi.mp.usr.cn/usrCloud/dev/slave/getTemplateSlaves
Content-Type: application/json
	
{
    "deviceTemplateId": 105222,
    "pageNo": 1,
    "pageSize": 100,
    "isNeedJson": 0
}
</pre>

#### 响应示例
status: 0，info: ok

<pre>
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "total": 1,
        "list": [
            {
                "id": 130197,
                "userId": 23598,
                "deviceTemplateId": 105222,
                "slaveIndex": "1",
                "slaveName": "未命名_从机名称_23",
                "slaveAddr": "1",
                "slaveIp": "192.168.1.111",
                "slavePort": 102,
                "createDt": "2022-01-26 16:27:33",
                "updateDt": "2022-01-26 16:27:34",
                "creator": 23598,
                "updator": 23598,
                "comIdx": 1,
                "relProtocolId": 6,
                "weight": 0,
                "promoteStatus": 0,
                "encrypted": 0,
                "deviceTemplateProtocolGroupList": [
                    {
                        "id": 4,
                        "pageNo": 1,
                        "pageSize": 10,
                        "title": "Modbus",
                        "titleEn": "Modbus",
                        "sort": 2,
                        "type": 0,
                        "createDt": "2019-05-31 14:09:12",
                        "updateDt": "2021-08-28 11:51:27",
                        "creator": 2,
                        "updator": 63562,
                        "children": [
                            {
                                "id": 6,
                                "pageNo": 1,
                                "pageSize": 10,
                                "title": "ModbusRTU",
                                "titleEn": "ModbusRTU",
                                "parentId": 4,
                                "parentIds": ",4,",
                                "type": 0,
                                "createDt": "2019-12-18 10:03:51",
                                "updateDt": "2019-12-18 10:03:51",
                                "creator": 2,
                                "updator": 2,
                                "children": [
                                    {
                                        "id": 6,
                                        "pageNo": 1,
                                        "pageSize": 10,
                                        "sort": 1,
                                        "type": 0,
                                        "createDt": "2019-05-31 09:05:43",
                                        "updateDt": "2020-12-01 10:24:23",
                                        "creator": 2,
                                        "updator": 71032,
                                        "children": [],
                                        "relProtocolGroupId": 6,
                                        "name": "边缘计算",
                                        "snSeriesModel": "0",
                                        "slaveType": 1,
                                        "datapointType": 3,
                                        "recommendContent": "",
                                        "pollingMethod": 1,
                                        "nameForDevice": "mb-rtu",
                                        "category": ",1,",
                                        "groupOrProtocolType": 1,
                                        "brand": "智泽",
                                        "brandEn": "ZhiZe",
                                        "encrypted": 0
                                    }
                                ],
                                "total": 1,
                                "groupOrProtocolType": 0
                            }
                        ],
                        "groupOrProtocolType": 0
                    }
                ],
                "status": 0,
                "addUpdateDt": true
            }
        ],
        "pageNum": 1,
        "pageSize": 100,
        "size": 1,
        "startRow": 1,
        "endRow": 1,
        "pages": 1,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": true,
        "isLastPage": true,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 8,
        "navigatepageNums": [
            1
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 1,
        "firstPage": 1,
        "lastPage": 1
    },
    "info": "ok"
}

</pre>