创建群组(API名称:createDeviceGroup)
功能介绍
用于与客户系统对接创建群组
相关接口
接口名称 |
调用说明 |
---|---|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
URL
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
---|---|---|---|
POST |
https://isdp+域名/openapi/v1/deviceGroup/createDeviceGroup |
OpenAPI |
application/json |
请求头
KEY |
VALUE |
是否必填 |
描述 |
---|---|---|---|
Content-Type |
application/json |
是 |
无 |
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
isdpDeviceIds |
String |
是 |
isdp唯一设备ID集合 多个通过英文逗号分隔,最多200个 |
projectNumber |
String |
是 |
项目编码 |
groupName |
String |
是 |
群组名称 |
响应参数
参数 |
类型 |
描述 |
---|---|---|
status |
Int |
响应状态 1标识成功,否则不成功 |
message |
String |
响应信息 SUCCESS标识成功,否则失败 |
error |
String |
错误信息 接口错误时有值,正常调用时为空 |
data |
String |
响应消息体 |
timestamp |
Date |
响应时间 |
请求示例
{ "projectNumber" : "0730", "isdpDeviceIds" : "HC4614--1", "groupName" : "1111" }
响应示例
{ "status" : 1, "message" : "SUCCESS", "error" : null, "data" : "createDeviceGroup success", "timestamp" : "2022-09-06T17:12:10.419+0800" }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。