SPM-Haupt-HTTP-API

Der Gerätetyp ist diy_meter (Typ=diy_meter) und die API-Schnittstellenversion des Geräts ist 1 (APIvers=1).

Ändert sich der Status des Subgeräts, muss die DNS-TXT das Feld „id“ enthalten, das die Chip-ID des Subgeräts darstellt. Das Subgerät sendet nur das geänderte Feld. Ändert sich der Switch des Subgeräts, wird nur das Switch-Feld gemeldet, das Feld „threshold overload_00“ wird nicht gemeldet.

In diesem Beispiel werden Zeilenumbrüche und Leerzeichen hinzugefügt, um die Lesbarkeit zu verbessern. Tatsächlich sind jedoch keine Zeilenumbrüche und Leerzeichen vorhanden.

 //All fields broadcast by sub-device
{
	"switches": [
    {
        "outlet":0,
        "switch":"on"
    },
    {
        "outlet":1,
        "switch":"on"
    },
    {
        "outlet":2,
        "switch":"on"
    },
    {
        "outlet":3,
        "switch":"on"
    }
],

//_00 represents the value of channel 1, _01 represents the value of channel 2, and so on
"current_00":100,
"voltage_00":22000,
"actPow_00":22000,
"reactPow_00":22000,
"apparentPow_00":22000,
  
"overload_00": 
{
    "minAP": {
        "en": 0,
        "val": 110000
    },
    "maxAP": {
        "en": 1,
        "val": 10000
    },
    "minV": {
        "en": 1,
        "val": 1000
    },
    "maxV": {
        "en": 0,
        "val": 22000
    },
    "maxC": {
        "en": 1,
        "val": 2000
    },
    "delayTime": 10
},
"overload_01":{},
"overload_02":{},
"overload_03":{},
"faultState": {
    "subDevCom": 0,
    "overloadTrig": [
        {
            "outlet": 0,
            "rsn": [1]
        },
        {
            "outlet": 2,
            "rsn": [3]
        }
    ],
    "cse7761Com": [
        1,
        0,
        1,
        1
    ],
    "overTemp": [
        0
    ],
    "overLimit": [
        {
            "outlet": 1,
            "rsn": [0]
        },
        {
            "outlet": 3,
            "rsn": [1]
        }
    ]
}
}

//If the switch status of the sub-device changes, only the switches field is reported.
{
"switches": [
    {
        "outlet":0,
        "switch":"on"
    },
    {
        "outlet":1,
        "switch":"on"
    },
    {
        "outlet":2,
        "switch":"on"
    },
    {
        "outlet":3,
        "switch":"on"
    }
]
}

//Report the PVC status of channel 1 in real time
{
"current_00":100,
"voltage_00":22000,
"actPow_00":22000,
"reactPow_00":22000,
"apparentPow_00":22000,
}


//Sub-device failure

{
"faultState": {
    "subDevCom": 0,
    "overloadTrig": [
        {
            "outlet": 0,
            "rsn": [1]
        },
        {
            "outlet": 2,
            "rsn": [3]
        }
    ],
    "cse7761Com": [
        1,
        0,
        1,
        1
    ],
    "overTemp": [
      	1,
        0,
      	1,
      	0
    ],
    "overLimit": [
        {
            "outlet": 1,
            "rsn": [0]
        },
        {
            "outlet": 3,
            "rsn": [1]
        }
    ]
}
}

URL: http://[ip]:[port]/zeroconf/deviceid
Rückgabewertformat: json
Methode: HTTP-Post

 { 
     "data": {} 
 }

Leeres Objekt, kein Attribut erforderlich.

Antworttext

 {
"seq": 2,
"error": 0,
"data": {
"deviceid": "1000012345"
}
}

URL: http://[ip]:[port]/zeroconf/add_sub_devices
Rückgabewertformat: json
Methode: HTTP-Post

 { 
    "deviceid": "100000140e", 
    "data": {} 
 }

Leeres Objekt, kein Attribut erforderlich.

Antworttext

 {
  "seq": 2,
  "error": 0,
 }

URL: http://[ip]:[port]/zeroconf/subDevList
Rückgabewertformat: json
Methode: HTTP-Post

 { 
    "deviceid": "100000140e", 
    "data": {} 
 }

Leeres Objekt, kein Attribut erforderlich.

Antworttext

 {
  "seq": 2,
  "error": 0,
  "data": {
    "subDevList": [
      {
        "subDevId": "123456",
        "type": 130
      }
    ]
  }
}

URL: http://[ip]:[port]/zeroconf/switches
Rückgabewertformat: json
Methode: HTTP-Post.

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456",
    "switches": [
      {
        "switch": "on",
        "outlet": 0
      },
      {
        "switch": "on",
        "outlet": 1
      },
      {
        "switch": "on",
        "outlet": 2
      },
      {
        "switch": "on",
        "outlet": 3
      }
    ]
  }
}

URL: http://[ip]:[port]/zeroconf/overload
Rückgabewertformat: json
Methode: HTTP-Post

Anforderungstext

 {
    "deviceid": "100000140e",
    "data": {
        "subDevId": "123456",
        "overload_00": 
        {
            "minAP": {
                "en": 0,
                "val": 110000
            },
            "maxAP": {
                "en": 1,
                "val": 10000
            },
            "minV": {
                "en": 1,
                "val": 9000
            },
            "maxV": {
                "en": 0,
                "val": 22000
            },
            "maxC": {
                "en": 1,
                "val": 2000
            },
            "delayTime": 10
        },
        "overload_01":{},
        "overload_02":{},
        "overload_03":{}
    },
}

Notiz:
-_00 stellt den Wert von Kanal 1 dar, _01 stellt den Wert von Kanal 2 dar und so weiter.
-Wenn die obere und untere Schwelle für Leistung und Spannung alle offen sind, muss die obere Schwelle größer als die untere Schwelle sein.

URL: http://[ip]:[port]/zeroconf/iAmHere
Rückgabewertformat: json
Methode: HTTP-Post

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456"
  }
}

Notiz:
-Diese Funktion kann das angegebene Untergerät über die Anzeigeleuchte finden.

URL: http://[ip]:[port]/zeroconf/time
Rückgabewertformat: json
Methode: HTTP-Post

 {
    "deviceid":"1000001234",
    "data": {
      "timeZone":8,
      "date":"2020-12-15T06:31:14.115Z"
    }
}

Notiz:
- Die historischen Daten der Untergeräte werden erst wirksam, nachdem die Zeitzoneninformationen festgelegt wurden, und haben keinen Einfluss auf die Einzelzeitstatistik.

URL: http://[ip]:[port]/zeroconf/historicalData
Rückgabewertformat: json
Methode: HTTP-Post

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456",
    "outlet": 3,
    "dateStart": "2020-07-10 05:30",
    "dateEnd": "2020-07-10 19:10"
  }
}

Antwort

1. Richtige Antwort:

Der Inhaltstyp des Antwortheaders ist application/octet-stream

Gibt Daten im CSV-Format (Comma-Separated Values) zurück. Die Datei enthält Kopfzeilen und normale Datensatzzeilen. Die Titelzeile enthält den entsprechenden Namen des Datensatzfelds. Jede normale Datensatzzeile ist ein Datensatz, und jeder Datensatz besteht aus neun durch Kommas getrennten Feldern.

Die Felder lauten in der Reihenfolge von links nach rechts wie folgt:
| Datum | Uhrzeit | Steckdose | Strom (A) | Spannung (V) | Wirkleistung (W) | Blindleistung (W) | Scheinleistung (W) | 5 Minuten Stromverbrauch (W·s) |

z.B
Benutzer fragen am 10. Oktober 2021 zwischen 00:00 und 00:20 Uhr Daten ab.

 Date, time, Outlet, Current(A), Voltage(V),Real power(W), Reactive power(W), 
Apparent power(W), 5 Minutes Power Consumption(W·s)
2021-10-10 , 0:0:0 , 0 , 0.00, 240.94, 0.56, 0.00, 0.55,172.00
2021-10-10 , 0:5:0 , 0 , 0.00, 241.41, 0.60, 0.00, 0.59,172.00
2021-10-10 , 0:10:0 , 0 , 0.00, 241.13, 0.51, 0.00, 0.55,173.00
2021-10-10 , 0:15:0 , 0 , 0.00, 240.94, 0.58, 0.00, 0.56,173.00
2021-10-10 , 0:20:0 , 0 , 0.00, 240.95, 0.57, 0.00, 0.57,173.00

2. Fehlerantwort:
   Siehe den allgemeinen Teil .

Notiz:
-Diese Funktion wird nach der Firmware-Version 1.1.0 veröffentlicht.
- Unterstützt Abfragedaten für bis zu 1 Tag.
Wenn dateStart beispielsweise „2020-07-10 05:30“ ist, kann dateEnd höchstens als „2020-07-11 00:00“ ausgefüllt werden.

URL: http://[ip]:[port]/zeroconf/monitor
Rückgabewertformat: json
Methode: HTTP-Post

 {
    "deviceid": "100000140e",
    "data": {
        "url": "http://www.123.com",
        "port": 7790,
        "subDevId": "123456",
        "outlet": 3,
        "time":180
    }
}

Notiz:
-Die URL unterstützt nur unverschlüsselte Verbindungen und das Format des Überwachungsdatenberichts ist eine HTTP-Post-Anforderung.

Gerätebericht:

 {
  "subDevId": 123456,
  "outlet": 3,
  "current": 100,
  "voltage": 22000,
  "actPow": 22000,
  "reactPow": 22000,
  "apparentPow": 22000
}

Meldebedingungen:
-Die Stromänderung übersteigt 0,03 A.
-Die Spannungsänderung überschreitet 5 V.
-Die Wirkleistungs-, Blindleistungs- oder Scheinleistungsänderung überschreitet 2 W.

URL: http://[ip]:[port]/zeroconf/wifi
Rückgabewertformat: json
Methode: HTTP-Post

 {
  "deviceid": "100000140e",
  "data": {
    "ssid": "eWeLink",
    "password": "WeLoveIoT"
  }
}

Notiz:
-Die neue WLAN-Einstellung wird bei der nächsten WLAN-Verbindung wirksam.

URL: http://[ip]:[port]/zeroconf/upgrade
Rückgabewertformat: json
Methode: HTTP-Post

 {
  "deviceid": "1000xxxxxx",
  "data": {
    "binList": [
      {
        "downloadUrl": "http://52.83.223.225:8088/ota/rom/hNLhVpovUgFJcipxmDD8fQv9b2BdJNgT/user1.1024.new.2.bin",
        "digest": "56a013b0f2ea151fb337a24025a5abb2f4390d4617c5ec57b27a79c86d6c4174",
        "name": "user1.bin"
      },
      {
        "downloadUrl": "http://52.83.223.225:8088/ota/rom/hNLhVpovUgFJcipxmDD8fQv9b2BdJNgT/user2.1024.new.2.bin",
        "digest": "62503540c241b4783bdc46026d86035b9d0775e2d48c59e40227be8067cadac6",
        "name": "user2.bin"
      }
    ]
  }
}

Die folgenden Fehlercodes werden dem Fehlerfeld des Antworttexts hinzugefügt:

1. 404 Nicht gefunden (Download fehlgeschlagen).
2. 409 Die Firmware-Verifizierung ist fehlgeschlagen.

URL: http://[ip]:[port]/zeroconf/record
Rückgabewertformat: json
Methode: HTTP-Post

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456",
    "rangeStart": 200,
    "rangeEnd": 229
  }
}

Antworttext

 {
    "seq": 2,
    "error": 0,
    "data": {
        "record": [
            {
                "date": "2020-07-29 18:00:05",
                "trigType": 1,
                "outlet": 1,
                "action": 1
            },
            {
                "date": "2020-07-29 18:02:05",
                "trigType": 0,
                "outlet": 1,
                "action": 0
            }
        ]
    }
}

Notiz:
-Die Bedingungen müssen erfüllt sein: rangeEnd>=rangeStart und rangeEnd-rangeStart<=29.

URL: http://[ip]:[port]/zeroconf/getState
Rückgabewertformat: json
Methode: HTTP-Post

z.B

1. Gateway-Status abrufen:

 {
    "deviceid":"1000001234",
    "data": {
    }
}

Antworttext

 {
    "seq": 2,
    "error": 0,
    "data": {
        "sledOnline":"on",
        "ssid": "eWeLink",
        "fwVersion": "3.5.0",
        "subChipFwVer": "3.5.0",
        "deviceid": "100000140e",
        "bssid": "xx:xx:xx:xx:xx:xx",
        "signalStrength": -10,
        "wifiConnected": true/false
    }
}

2. Status des Untergeräts abrufen:

 {
    "deviceid":"1000001234",
    "data": {
        "subDevId": "123456"
    }
}

Antworttext

 {
    "seq": 2,
    "error": 0,
    "data": {
      	"fwVersion": "1.1.1",
        "switches": [
            {
                "outlet":0,
                "switch":"on"
            },
            {
                "outlet":1,
                "switch":"on"
            },
            {
                "outlet":2,
                "switch":"on"
            },
            {
                "outlet":3,
                "switch":"on"
            }
        ],
        "overload_00": 
        {
            "minAP": {
                "en": 0,
                "val": 110000
            },
            "maxAP": {
                "en": 1,
                "val": 10000
            },
            "minV": {
                "en": 1,
                "val": 1000
            },
            "maxV": {
                "en": 0,
                "val": 22000
            },
            "maxC": {
                "en": 1,
                "val": 2000
            },
            "delayTime": 10
        },
        "overload_01":{},
        "overload_02":{},
        "overload_03":{},
        "faultState": {
            "subDevCom": 0,
            "cse7761Com": [
                1,
                0,
                1,
                1
            ]
        },
        "threshold": {
            "actPow":{
                "min":10,
                "max":440000
            },
            "voltage":{
                "min":10,
                "max":440000
            },
            "current":{
                "min":10,
                "max":440000
            }
        }
    }
}

URL: http://[ip]:[port]/zeroconf/ops_mode
Rückgabewertformat: json
Methode: HTTP-Post

 {
    "deviceid":"1000001234",
    "data": {
        "ops_mode": "ewelink"
    }
}

Notiz:
„ops_mode“: „ewelink“ bedeutet, zurück in den Ewelink-Modus zu wechseln.