Get Event


通过 eventId 获取事件的详细信息。

请求格式

GET https://{apigw-address}/connect-service/v2.1/events?action=get

请求参数(URI)

名称

位置(Path/Query)

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织 ID。 如何获取 orgId 信息>>

eventId

Query

必需

String

事件标识符。

resolveName

Query

可选

Boolean

  • true:分解 output 信息,返回 eventNameoutputNames 参数。

  • false(默认):不分解 output 信息。eventNameoutputNames 参数皆为空值。

响应参数

名称

数据类型

描述

data

Event 结构体

有关 Event 结构体的定义,见 Event 结构体

Event 结构体

名称

数据类型

描述

orgId

String

资产所属的组织 ID。

eventId

String

事件 ID。

productKey

String

Product Key。

deviceKey

String

Device Key。

assetId

String

资产 ID。

tslEventKey

String

TSL 模型中的事件 Key。

tslEventType

String

TSL 模型中定义的事件类型。

output

String

事件的输出。

outputData

Map(Key 为 String,Value 为 Object)

事件的输出 JSON 格式。

timestamp

Long

事件发生时间戳。

localtime

String

事件发生本地时间。

eventName

StringI18n

事件的名称。结构参见 国际化名称结构体

outputNames

Map(Key 为 String,Value 为 StringI18n)

事件的输出名称。

示例

请求示例

url: https://{apigw-address}/connect-service/v2.1/events?action=get&eventId=yourEventId&orgId=yourOrgId&resolveName=true
method: GET

返回示例

{
  "code": 0,
  "msg": "OK",
  "requestId": "437f3075-448c-4995-9bf5-81e15382615c",
  "data": {
    "eventId": "20210323d3a7738134ae8a33f569d4fea8f4d57c",
    "orgId": "yourOrgId",
    "productKey": "yourProductKey",
    "deviceKey": "yourDeviceKey",
    "assetId": "yourAssetId",
    "tslEventKey": "yourEventKey",
    "tslEventType": "INFO",
    "output": "{\"test\":12,\"branchCurr\":[1.1,2.1,3.1],\"Power\":11.1}",
    "outputData": {
      "test": 12,
      "branchCurr": [
          1.1,
          2.1,
          3.1
      ],
      "Power": 11.1
    },
    "timestamp": 1616493875000,
    "localtime": "2021-03-23 18:04:35",
    "eventName": {
      "defaultValue": "电流阈值",
      "i18nValue": {
          "en_US": "",
          "zh_CN": ""
      }
    },
    "outputNames": {
      "test": {
        "defaultValue": "test",
        "i18nValue": {
            "en_US": "test",
            "zh_CN": "测试"
        }
      },
      "branchCurr": {
        "defaultValue": "branchCurr",
        "i18nValue": {
            "en_US": "branchCurr",
            "zh_CN": "当前分支"
        }
      },
      "Power": {
        "defaultValue": "Power",
        "i18nValue": {
            "en_US": "Power",
            "zh_CN": "电量"
        }
      }
    }
  }
}

Java SDK 调用示例

package com.envisioniot.enos.api.sample.connect_service.event;

import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.connect_service.v2_1.event.GetEventRequest;
import com.envisioniot.enos.connect_service.v2_1.event.GetEventResponse;
import com.google.gson.Gson;


public class GetEvent {
    public static void main(String[] args) {
        String appKey = "yourAppKey";
        String appSecret = "yourAppSecret";

        GetEventRequest request = new GetEventRequest();
        request.setOrgId("yourOrgId");
        request.setEventId("yourEventId");
        request.setResolveName(true);
        try {
            GetEventResponse response = Poseidon.config(PConfig.init().appKey(appKey).appSecret(appSecret).debug())
                .url("yourServerUrl")
                .getResponse(request, GetEventResponse.class);
            Gson gson = new Gson();
            System.out.println(gson.toJson(response));
        } catch (Exception e) {
            System.out.print(e);
        }
    }
}