1.1.事件报送（设备报警、处警、心跳；数据增、删、改）

概述

本接口采用 http 协议+json 数据格式，将设备运行状况及报警信息，推送至第三方服务器，方便第三方平台采数据。

推送方式

请求协议： http
请求地址： 由客户提供
请求方法： post
消息内容： http 协议 body 体内
内容格式： application/json; charset=utf-8

安全认证

由第三方平台提供请求地址（endpoint）和签名票据（ticket），本接口会根据消息内容、时间戳和签名票据，生成签名，附加在 http 协议 headers 中，签名参数名：X-Signature，时间戳参数名：X-Timestamp。第三方平台可根据签名算法，校验消息来源。注意：如果第三方平台不提供签名票据，则不会生成签名。

签名算法

消息内容、时间戳、签名票据都采用 utf-8 编码，消息内容+时间戳+签名票据拼接成字符串 string1，对 string1 作 sha1 加密得到签名。

示例

步骤 1：
消息内容为：

{"facility":{"addrStr":"869662033589802","descr":"无线设备参与联动测试","facilitiesCode":2,"facilitiesModel":"JBF-VH76N","facilitiesModelId":7,"facilitiesType":"无线感烟","facilitiesTypeCode":332,"facilityId":565788,"isWireless":1},"fireUnit":{"address":"北京市海淀区成府路207号","id":75,"latitude":39.999008,"longitude":116.32534,"name":"北大青鸟"},"stat":[{"time":1565838801,"type":6,"typeStr":"故障","val":66,"valStr":"分离故障"}]}

当前时间戳为：

1565838801305

签名票据为：

步骤 2：
按顺序拼接消息内容、时间戳、签名票据，得到 string1：

{"facility":{"addrStr":"869662033589802","descr":"无线设备参与联动测试","facilitiesCode":2,"facilitiesModel":"JBF-VH76N","facilitiesModelId":7,"facilitiesType":"无线感烟","facilitiesTypeCode":332,"facilityId":565788,"isWireless":1},"fireUnit":{"address":"北京市海淀区成府路207号","id":75,"latitude":39.999008,"longitude":116.32534,"name":"北大青鸟"},"stat":[{"time":1565838801,"type":6,"typeStr":"故障","val":66,"valStr":"分离故障"}]}15658388013051231

步骤 3：
对 string1 进行 sha1 签名，得到签名：

20770ba8fc475bf417d27a09b0d2c86c52aebba7

签名算法示例-Java

请求参数

Header 参数

Body 参数application/json

示例

{
    "event": "string",
    "facility": {
        "facilitiesCode": 0,
        "id": 0,
        "addrStr": "string",
        "descr": "string",
        "isWireless": 0,
        "online": 0,
        "imei": "string",
        "imsi": "string",
        "net": "string",
        "facilitiesTypeCode": 0,
        "facilitiesType": "string",
        "facilitiesModelId": 0,
        "facilitiesModel": "string",
        "analogType": "string",
        "analogValue": "string",
        "temperature": 0,
        "voltage": "string",
        "rssi": 0,
        "longitude": 0,
        "latitude": 0,
        "extraInfo": {
            "powerArr": [
                {
                    "phase": "string",
                    "active": 0,
                    "reactive": 0,
                    "apparent": 0,
                    "powerFactor": 0
                }
            ],
            "malignantLoadArr": [
                {
                    "phase": "string",
                    "enable": 0,
                    "time": 0,
                    "power": 0
                }
            ],
            "energyUsedArr": [
                {
                    "phase": "string",
                    "active": 0,
                    "reactive": 0,
                    "reverseActive": 0,
                    "forwardActive": 0,
                    "reverseReactive": 0,
                    "forwardReactive": 0,
                    "main": 0
                }
            ],
            "currentArr": [
                {
                    "phase": "string",
                    "analogType": "string",
                    "analogValue": 0,
                    "ratedCurrent": 0,
                    "enable": 0,
                    "overcurrentRatio": 0,
                    "transformationRatio": 0
                }
            ],
            "voltageArr": [
                {
                    "phase": "string",
                    "enable": 0,
                    "analogType": "string",
                    "analogValue": 0,
                    "overvoltageRatio": 0,
                    "undervoltageRatio": 0
                }
            ],
            "switch": {
                "enable": 0,
                "lackCurrent": 0,
                "temperature": 0,
                "current": 0,
                "voltage": 0
            },
            "lineType": 0
        },
        "energyUsedA": 0,
        "energyUsedB": 0,
        "energyUsedC": 0,
        "currentA": 0,
        "currentB": 0,
        "currentC": 0,
        "voltageA": 0,
        "voltageB": 0,
        "voltageC": 0,
        "powerA": 0,
        "powerB": 0,
        "powerC": 0
    },
    "fireUnit": {
        "id": 0,
        "name": "string",
        "address": "string",
        "latitude": 0,
        "longitude": 0
    },
    "stat": [
        {
            "id": 0,
            "time": 0,
            "type": 0,
            "typeStr": "string",
            "val": 0,
            "valStr": "string"
        }
    ],
    "treat": {
        "id": 0,
        "time": 0,
        "treatTime": "string",
        "treator": "string",
        "treatType": 0,
        "treatTypeStr": "string"
    },
    "linkman": {
        "id": 0,
        "unitType": 0,
        "unitId": 0,
        "name": "string",
        "phone": "string"
    }
}

1.1.事件报送（设备报警、处警、心跳；数据增、删、改）

概述#

推送方式#

安全认证#

签名算法#

示例#

签名算法示例-Java#

请求参数

返回响应

概述

推送方式

安全认证

签名算法

示例

签名算法示例-Java