API D1

Le type d'appareil est diylight (type=diylight) et la version de l'interface API de l'appareil est 1 (apivers=1).

URL : http://[ip]:[port]/zeroconf/switch
Format de la valeur de retour : json
Méthode : HTTP post

 { 
    "deviceid": "", 
    "data": {
        "switch": "on" 
    } 
 }

URL : http://[ip]:[port]/zeroconf/dimmable
Format de la valeur de retour : json
Méthode : HTTP post

 { 
    "deviceid": "", 
    "data": {
        "switch": "on", 
        "brightness": 30,
        "mode": 0,
        "brightmin": 10, 
        "brightmax": 255
    } 
 }

Note:

• Pour régler la luminosité de la lumière, la lumière doit être « allumée », donc si vous envoyez une requête API Dimmble avec « switch » : « off », elle signalera une erreur « 400 » car l'opération a échoué.
• Le paramètre « mode » est utilisé pour le développement d'applications pour définir différents modes avec une luminosité spécifique et synchroniser le contenu des modes de l'appareil lors du partage du fonctionnement de l'appareil avec d'autres.
  Par exemple:
  L'application du développeur définit deux modes (mode 1 : luminosité = 5 ; mode 2 : luminosité = 50) dans lesquels l'appareil peut atteindre une luminosité spécifique à l'aide de boutons, le paramètre « mode » permet de synchroniser le mode de l'appareil pour tous les utilisateurs partagés.
• La valeur de brightmin doit être inférieure à brightmax.

URL : http://[ip]:[port]/zeroconf/startup
Format de la valeur de retour : json
Méthode : HTTP post

 { 
    "deviceid": "", 
    "data": {
        "startup": "stay"
    } 
 }

URL : http://[ip]:[port]/zeroconf/signal_strength
Format de la valeur de retour : json
Méthode : HTTP post

Corps de la requête

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

Objet vide, aucun attribut n'est requis.

Corps de la réponse

 { 
    "seq": 2, 
    "error": 0, 
    "data": { 
        "signalStrength": -67 
	}
}

URL : http://[ip]:[port]/zeroconf/wifi
Format de la valeur de retour : json
Méthode : HTTP post

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

URL : http://[ip]:[port]/zeroconf/ota_unlock
Format de la valeur de retour : json
Méthode : HTTP post

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

Objet vide, aucun attribut n'est requis.

Les codes d’échec suivants sont ajoutés au champ d’erreur du corps de la réponse :
– 500 : L'opération a échoué et l'appareil présente des erreurs. Par exemple, l'ID de l'appareil ou la clé API n'est pas authentifiée par le service de déverrouillage OTA du fournisseur ;
– 503 : L'opération a échoué et l'appareil ne peut pas demander le service de déverrouillage OTA du fournisseur. Par exemple, l'appareil n'est pas connecté au Wi-Fi, à Internet, le service de déverrouillage OTA du fabricant est en panne, etc.

URL : http://[ip]:[port]/zeroconf/ota_flash
Format de la valeur de retour : json
Méthode : HTTP post

 { 
    "deviceid": "", 
    "data": {
        "downloadUrl": "http://192.168.1.184/ota/new_rom.bin", 
        "sha256sum": "3213b2c34cecbb3bb817030c7f025396b658634c0cf9c4435fc0b52ec9644667"
    } 
 }

Les codes d’échec suivants sont ajoutés au champ d’erreur du corps de la réponse :
– 403 : L'opération a échoué et la fonction OTA n'a pas été déverrouillée. L'interface « 3.2.6 Déverrouillage de la fonction OTA » doit d'abord être appelée avec succès.
– 408 : L'opération a échoué et le délai de prétéléchargement du micrologiciel a expiré. Vous pouvez réessayer d'appeler cette interface après avoir optimisé l'environnement réseau ou augmenté la vitesse du réseau.
– 413 : L'opération a échoué et la taille du corps de la requête est trop importante. La taille du nouveau micrologiciel OTA dépasse la limite autorisée par l'appareil.
– 424 : L'opération a échoué et le téléchargement du micrologiciel a échoué. L'adresse URL est inaccessible (adresse IP inaccessible, protocole HTTP inaccessible, micrologiciel inexistant, serveur non compatible avec l'en-tête de requête Range, etc.).
– 471 : L'opération a échoué, ainsi que la vérification de l'intégrité du micrologiciel. La somme de contrôle SHA256 du nouveau micrologiciel téléchargé ne correspond pas à la valeur du champ sha256sum du corps de la requête. Le redémarrage de l'appareil entraînera un problème de bricking.

Note:

• La taille maximale du firmware est de 508 Ko.
• Le mode de lecture flash SPI doit être DOUT.

URL : http://[ip]:[port]/zeroconf/info
Format de la valeur de retour : json
Méthode : HTTP post

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

Objet vide, aucun attribut n'est requis.

Corps de la réponse

 { 
    "seq": 2, 
    "error": 0,
    "data": {
        "switch": "off",
        "startup": "off",
        "brightness": 30,
        "mode": 0,
        "brightmin": 10, 
        "brightmax": 255,
        "ssid": "eWeLink",
        "otaUnlock": false,
        "fwVersion": "3.5.0",
        "deviceid": "100000140e",
        "bssid": "ec:17:2f:3d:15:e",
        "signalStrength": -25
	}
 }

Note:

• Surveillez et analysez l'enregistrement DNS TXT de l'appareil pour obtenir les informations de l'appareil en temps réel.