Speisekarte

B02-BL/B05-BL API

B02-BL/B05-BL HTTP-API

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

Geräteinformationen abrufen

URL: http://[ip]:[port]/zeroconf/info

Rückgabewertformat: json

Methode: HTTP-Post

 { 
    "deviceid": "1000000001", 
    "data": {} 
 }

Antworttext

 { 
    "seq": 2, 
    "error": 0,
    "data": {
        "switch": "off",
        "startup": "off",
        "pulse": "off",
        "pulseWidth": 500,
        "ssid": "eWeLink",
        "otaUnlock": false,
        "fwVersion": "3.5.0",
        "deviceid": "100000140e",
        "bssid": "ec:17:2f:3d:15:e",
        "signalStrength": -25
    }
}

Ein- und Ausschalten

URL: http://[ip]:[port]/zeroconf/switch

Rückgabewertformat: json

Methode: HTTP-Post

 { 
    "deviceid": "1000000001", 
    "data": {
        "switch": "on"
    } 
 }
Attribut Typ Optional Beschreibung
schalten Zeichenfolge NEIN an: Licht anschalten, aus: Licht ausschalten

Dimmbares Licht

URL: http://[ip]:[port]/zeroconf/dimmable

Rückgabewertformat: json

Methode: HTTP-Post

 {
//Change the light to cool & warm type
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype": "white",
 "white": {"br": 70, "ct": 100}
 }
}
//Change the light to RGBCW type
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype": "color",
 "color": {"br": 100, "r": 255, "g": 0, "b": 0}
 }
}
//Bright
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"bright",
 "bright":{"r":255,"g":255,"b":255,"br":100} 
 }
}
//Sleep
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype": "goodNight",
 "goodNight": {"r":255,"g":250,"b":125,"br":25}
 }
}
//Read
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"read",
 "read":{"r":255,"g":255,"b":255,"br":60}
 }
}
//Night
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"nightLight",
 "nightLight":{"r":255,"g":240,"b":225,"br":5}
 }
}
// The following Scene can be modified options in the app
//Party
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"party",
 "party":{"r":254,"g":132,"b":0,"br":45,"tf":1,"sp":1}
 }
}
//Relax
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"leisure",
 "leisure":{"r":0,"g":40,"b":254,"br":55,"tf":1,"sp":1}
 }
}
//Soft
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"soft",
 "soft":{"r":38,"g":254,"b":0,"br":20,"tf":1,"sp":1}
 }
}
//Vivid
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"colorful",
 "colorful":{"r":255,"g":0,"b":0,"br":100,"tf":1,"sp":1}
 }
}
Attribut Typ Optional Beschreibung
ltyp Zeichenfolge NEIN Lichtmodus, einschließlich Weiß, Farbe, Hell, Gute Nacht, Lesen, Nachtlicht, Party, Freizeit, Weich, Bunt
Weiß Objekt Ändern Sie den Typ auf kühl und warm
Farbe Objekt Ändern Sie den Typ in RGBCW
hell Objekt Ändern Sie die Szene auf „Hell“
Gute Nacht Objekt Ändern Sie die Szene auf „Schlafen“
lesen Objekt Ändern Sie die Szene in „Lesen“
NachtLicht Objekt Ändern Sie die Szene auf „Nacht“
Party Objekt Ändern Sie die Szene auf „Party“
Freizeit Objekt Ändern Sie die Szene auf „Entspannen“
weich Objekt Ändern Sie die Szene auf „Weich“
bunt Objekt Ändern Sie die Szene auf „Lebhaft“
br Nummer NEIN Helligkeit, [1,100]
ct Nummer NEIN Farbtemperatur, [0,100]
R Nummer NEIN Rotwert, [0,255]
G Nummer NEIN Grünwert, [0,255]
B Nummer NEIN Blauwert, [0,255]
tf Nummer NEIN Farbtransformationsmodus, [1,3]. 1: Statisch, 2: Allmählich, 3: Flimmern
sp Nummer NEIN Farbtransformationsgeschwindigkeit, [1.100]. Je höher die Zahl, desto schneller die Geschwindigkeit.

WLAN-SSID- und Passworteinstellung

URL: http://[ip]:[port]/zeroconf/wifi

Rückgabewertformat: json

Methode: HTTP-Post

 { 
    "deviceid": "", 
    "data": {
        "ssid": "eWeLink", 
        "password": "WeLoveIoT"
    } 
}
Attribut Typ Optional Beschreibung
SSID Zeichenfolge NEIN SSID des WLAN-Netzwerks, mit dem sich das Gerät verbinden wird
Passwort Zeichenfolge NEIN Passwort des WLAN-Netzwerks, mit dem sich das Gerät verbinden wird

WLAN-Signalstärke

URL: http://[ip]:[port]/zeroconf/signal_strength

Rückgabewertformat: json

Methode: HTTP-Post

 { 
    "deviceid": "1000000001", 
    "data": {} 
 }

Antworttext

 { 
    "seq": 2, 
    "error": 0, 
    "data": { 
        "signalStrength": -67 
    }
}
Attribut Typ Optional Beschreibung
Signalstärke Nummer NEIN Die aktuell vom Gerät empfangene WLAN-Signalstärke, negative Ganzzahl, dBm

Freischalten der OTA-Funktion

URL: http://[ip]:[port]/zeroconf/ota_unlock

Rückgabewertformat: json

Methode: HTTP-Post

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

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

– 500: Der Vorgang ist fehlgeschlagen und das Gerät weist Fehler auf. Beispielsweise liegt ein Fehler bei der Geräte-ID oder dem API-Schlüssel vor, der vom OTA-Entsperrdienst des Anbieters nicht authentifiziert wurde.

– 503: Der Vorgang ist fehlgeschlagen und das Gerät kann den OTA-Entsperrdienst des Herstellers nicht anfordern. Beispielsweise ist das Gerät nicht mit WLAN oder dem Internet verbunden, der OTA-Entsperrdienst des Herstellers ist ausgefallen usw.

OTA Neue Firmware

URL: http://[ip]:[port]/zeroconf/ota_flash

Rückgabewertformat: json

Methode: HTTP-Post

 { 
    "deviceid": "", 
    "data": {
        "downloadUrl": "http://192.168.1.184/ota/new_rom.bin", 
        "sha256sum": "3213b2c34cecbb3bb817030c7f025396b658634c0cf9c4435fc0b52ec9644667"
    } 
}
Attribut Typ Optional Beschreibung
Download-URL Zeichenfolge NEIN Die Download-Adresse der neuen Firmware unterstützt nur das HTTP-Protokoll, der HTTP-Server muss den Range-Anforderungsheader unterstützen.
sha256sum Zeichenfolge NEIN SHA256-Prüfsumme (Hash) der neuen Firmware, wird verwendet, um die Integrität der heruntergeladenen neuen Firmware zu überprüfen

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

– 403: Der Vorgang ist fehlgeschlagen und die OTA-Funktion wurde nicht freigeschaltet. Die Schnittstelle „3.2.6 Freischalten der OTA-Funktion“ muss zuerst erfolgreich aufgerufen werden.

– 408: Der Vorgang ist fehlgeschlagen und die vor dem Download der Firmware abgelaufen. Sie können versuchen, diese Schnittstelle erneut aufzurufen, nachdem Sie die Netzwerkumgebung optimiert oder die Netzwerkgeschwindigkeit erhöht haben.

– 413: Der Vorgang ist fehlgeschlagen und der Anforderungstext ist zu groß. Die Größe der neuen OTA-Firmware überschreitet die vom Gerät zulässige Firmware-Größenbeschränkung.

– 424: Der Vorgang ist fehlgeschlagen und die Firmware konnte nicht heruntergeladen werden. Die URL-Adresse ist nicht erreichbar (IP-Adresse nicht erreichbar, HTTP-Protokoll nicht erreichbar, Firmware nicht vorhanden, Server unterstützt den Range-Anforderungsheader nicht usw.).

– 471: Der Vorgang ist fehlgeschlagen, und die Integritätsprüfung der Firmware ist fehlgeschlagen. Die SHA256-Prüfsumme der heruntergeladenen neuen Firmware stimmt nicht mit dem Wert des Felds „sha256sum“ im Anforderungstext überein. Ein Neustart des Geräts führt zu einem Bricking-Problem.

Notiz:

  • Die maximale Firmwaregröße beträgt 508 KB.

  • Der SPI-Flash-Lesemodus muss DOUT sein.

Vorherige
D1 API
Nächste
MINIR3 API
Kürzlich geändert: 2025-06-25