Skip to content

Create window grouping

Request method and path

html
POST http://localhost:[Port]/openapi/window/group/create?ticket=[OpenApiTicket]

Interface Function Description

Used to create window groups.

Request parameter

Parameter NameRequiredtypeExplanation
windowGroupBasicInfoYobjectwindow Group Object view

Request parameter example

json
{
  "windowGroupBasicInfo": {
    "windowGroupName": "124",
    "isDefault": true,
    "enable": true
  }
}

Detailed explanation of parameters

windowGroupBasicInfo Parameter Description

Parameter NameRequiredtypeExplanation
windowGroupNameYstringGroup Name
isDefaultYboolIs it set as the default group for the system
enableYboolGroup Enable

Example of Interface Response Result

Successful Response Example

Return parameters

newWindowGroupKey: The unique identifier of the newly created group.

json
{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "success",
    "errorCode": "",
    "errorMsg": "",
    "result": {
      "newWindowGroupKey": 123
    }
  }
}

Example of failed response



Failed to call interface

When the interface response status code is not '00000', the interface call fails.
The specific reasons for interface call errors can be found in the Interface Response Status Code Information Comparison Table for querying.

json
{
  "code": "00001",
  "message": "Unknown error occurred, please provide feedback to official customer service!",
  "data": {}
}

This modification operation failed

json
{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "failed",
    "errorCode": "E01",
    "errorMsg": "Missing parameter (xxx).",
    "result": {}
  }
}

Operation failure errorCode error code information comparison table

Error codeReason for error
E00The format of parameter (xxx) is incorrect!
E01Missing parameter (xxx).
E02The parameters are redundant.
E03Missing parameters windowGroupBasicInfo.(xxx)。
E04The parameters in windowGroupBasicInfo are redundant.
E05We are about to exceed the maximum capacity of 50 groups. Please delete some of the group lists (i.e. template lists) and try again!
E06The value of the unique number index for window grouping has exceeded the maximum allowable value of 200. Please delete some of the later grouping lists (i.e. template lists) and try again!