Skip to content

Arrange window browser

Request method and path

html
POST http://localhost:[post]/openapi/app/arrange/window-browser?ticket=[OpenApiToken]

Interface function description

Arrange all open browser Windows in the APP.

Request parameter

Header Request Data

namevaluerequiredtypeExplanation
Content-Typeapplication/jsonYStringapplication/json

Body Request parameter

nameRequiredtypeExplanation
screen_idYnumberSpecify display ID-1: indicates that the renderer user setting is used
arrange_typeYstringWindow arrangement: null: Use user Settings on the rendering side. advance : Advanced custom, stacking : Stacking, nineSquareGrid : nine grid
advance_paramsNnull || objectThe value can be null or not. If the value is null or not, advanced configurations in the client system Settings are used View configuration items

Parameter detail

advance_params Description of key values of configuration parameter objects

nameRequiredtypeExplanation
xYnumberThe lateral distance of the arranged window position from the left
yYnumberThe longitudinal distance of the arranged window position from the top side
widthYnumberWidth of window >=500
heightYnumberHeight of window >=375
horizontalSpacingYnumberHorizontal spacing between two Windows
verticalSpacingYnumberVertical spacing between two Windows
windowNumYnumberA row shows the number of Windows arranged

Request parameter example

json
{
  "screen_id": 2,
  "arrange_type": "advance",
  "advance_params": {
    "x": 110,
    "y": 0,
    "width": 500,
    "height": 375,
    "horizontalSpacing": 0,
    "verticalSpacing": 0,
    "windowNum": 3
  }
}

Example of Interface Response Result

Successful Response Example

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

Example of failed response



Failed to call interface

When the interface response status code is not '00000', the interface call fails.
The specific interface call Reason for error can be queried by viewing the Interface Response Status Code Information Comparison Table.

json
{
  "code": "00001",
  "message": "产生未知错误,请反馈给官方客服!",
  "data": {}
}

This operation failed

json
{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "failed",
    "errorCode": "E011",
    "errorMsg": "当前尚未打开任何浏览器",
    "result": {}
  }
}

Operation failure errorCode error code information comparison table

Error codeReason for error
E002arrange_type Must be a value in advancestackingnineSquareGrid
E003Unknown exception! Please feedback to the official customer service.
E011No browsers are currently open