Scene information interface

The GVP platform provides interfaces related to scene information. Scene control is a logical function of the GVP platform. Through scene control, multiple objectives can be controlled simultaneously, such as multiple lighting devices or air conditioning devices. The GVP platform allows for free editing of scene control objectives.

1. Obtain information of all scene buttons

Request interface example, 192.168.1.108 is the IP address of the computer where the GVP server is located. Please adjust according to the actual situation

http://192.168.1.108:8008/api/?HDLRequest=GetAllSceneList

Request method: POST

Interface Address: /api/?HDLRequest=GetAllSceneList

Request data type: application/json

Response data type: application/json

Interface Description: Obtain data on all scene button information

Headers parameter

Key Value Description
Authorization Token Value The Token value obtained upon successful login. If it has expired, please log in again

Request parameters, none

Request example, empty, or any data. This interface ignores the verification of request parameters

null,{}

Response parameters:

Field Type Description
ReplyCode String Response code
ReplyMessage String Response message prompt
ReplyDataType Integer Response data type, can be ignored
ReplyObject Array Response data. For detailed information, refer to the example description

Response success example:

{
    "ReplyCode": "Success",
    "ReplyMessage": "Success",
    "ReplyDataType": 0,
    "ReplyObject": [
        {
            "SceneGuid": "a160e51f-28d8-41d4-9132-1e82a891a04c", // Unique GUID for the scene button
            "SceneName": "Scene 1", // Scene name
            "SceneType": 0, // ignored by third-party platforms
            "SceneControlStyle": 1, // Scene button type: 0 for forward control, 1 for both forward and reverse control
            "ZoneGuid": "4ed78e21-397b-4e13-ba68-8eabba45d8b3", // GUID of the area where the scene button is located
            "ZoneName": "Bathroom", // Name of the area where the scene button is located
            "SceneZoneLevelName": "Hedong Enterprise → Tianhe Office → First Floor → Restroom" // Level information of the area where the scene button is located
        },
        {
            "SceneGuid": "cafe29f4-5bb8-4680-b1ed-ec3ae75f5fd0", // Unique GUID for the scene button
            "SceneName": "Scene 2", // Scene name
            "SceneType": 0, // ignored by third-party platforms
            "SceneControlStyle": 1, // Scene button type: 0 for forward control, 1 for both forward and reverse control
            "ZoneGuid": "4ed78e21-397b-4e13-ba68-8eabba45d8b3", // GUID of the area where the scene button is located
            "ZoneName": "Bathroom", // Name of the area where the scene button is located
            "SceneZoneLevelName": "Hedong Enterprise → Tianhe Office → First Floor → Restroom" // Level information of the area where the scene button is located
        }
    ],
    "TotalRowCount": 0,
    "AlarmCount": 0,
    "PageCount": 0
}

2. Control scenario information

Request interface example, 192.168.1.108 is the IP address of the computer where the GVP server is located. Please adjust according to the actual situation

http://192.168.1.108:8008/api/?HDLRequest=ControlSceneButton

Request method: POST

Interface address: /api/?HDLRequest=ControlSceneButton

Request data type: application/json

Response data type: application/json

Interface Description: This interface controls scene buttons and specifies individual scene information for control

Headers parameter

Key Value Description
Authorization Token Value The Token value obtained upon successful login. If it has expired, please log in again

Request parameters

Field Type Required Description
SceneGuid String true The unique Guid of the scene button, obtained when querying all scene button information. It must be included during control.

Request example, but the string must be encrypted using an encryption method before submission

{"SceneGuid":""}

Response parameters:

Field Type Description
ReplyCode String Response code
ReplyMessage String Response message prompt
ReplyDataType Integer Response data type, can be ignored
ReplyObject Array Response data. For detailed information, refer to the example description

Response success example:

{
    "ReplyCode": "Success",
    "ReplyMessage": "Success",
    "ReplyDataType": 0,
    "ReplyObject": {},
    "TotalRowCount": 0,
    "AlarmCount": 0,
    "PageCount": 0
}

results matching ""

    No results matching ""