Skip to content

bts-lasalle-avignon-ressources/PhilipsHue

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits

images

images

 
 

specifications

specifications

 
 

src

src

 
 

.gitignore

.gitignore

 
 

README.md

README.md

 
 

Repository files navigation

PhilipsHue

Présentation

Philips fut fondé par Gerhard et Frederik Philips à Eindhoven en 1891 avec la production d'ampoules à filament de charbon.

Philips Hue est une sous-marque qui fait partie de la famille Philips et elle est dédiée à l’éclairage connecté.

La sous-marque Philips Lighting est devenu Signify. Les produits Philips Hue existent depuis 2013.

Pionnier dans le secteur de l'éclairage connecté, Philips Hue est devenu un écosystème propriétaire de gestion de produits connectés (Domotique) communiquant en ZigBee.

Pionnier dans le secteur de l'éclairage connecté, Philips Hue dispose d'une gamme importante d'ampoules et de luminaires qui communiquent en ZigBee.

Tip

Les lumières Philips Hue peuvent aussi être contrôlées via Bluetooth pour obtenir un ensemble limité de fonctionnalités.

L'utilisation du ZigBee nécessite la présence d'une passerelle nommée « pont de connexion » (Hue Bridge). Un pont (ou hub) Hue Bridge peut supporter jusqu’à 50 ampoules.

Le pont Philips Hue Bridge prend en charge Matter.

La maquette

La maquette de test est composé :

  • d'une passerelle Hue Bridge

  • de trois ampoules Hue White and Color Ambiance A60 E27 9W

  • d'un Hue Motion Sensor détecteur de mouvement

  • d'un Hue Dimmer switch télécommande nomade et variateur de Lumière

Il faut commencer par installer le pont Hue puis les appareils en suivant les instructions fournies par Philips.

Application Hue

L'application principale du système Philips Hue vous permet d'allumer et d'éteindre vos lumières, de créer des automatisations et des minuteries, de synchroniser vos éclairages avec votre TV et votre musique, de contrôler votre système de sécurité connectée pour la maison.

Important

L'application Hue va aussi permettre de mettre à jour la version logicielle du pont Hue. Il est conseillé de la faire.

Liens :

Warning

Il faudra trouver l'application en fonction de la version Android : https://philips-hue.fr.uptodown.com/android/versions

Philips Hue fonctionne avec de nombreux appareils, plates-formes et assistants pour une maison connectée :

Les applications compatibles avec Philips Hue : https://www.philips-hue.com/fr-fr/explore-hue/works-with

Prise en main

Une fois la mise à jour logicielle du pont Hue réalisée, il faut déterminer son adresse IP sur le réseau :

$ curl -k --location https://discovery.meethue.com/
[{"id":"XXXXXXXXXXXXXXXX","internalipaddress":"192.168.52.182","port":443}]

Sinon, il faudra utiliser wireshark.

On peut alors obtenir une description du pont Hue :

$ curl -k --location  http://192.168.52.182/description.xml
<root>
    <specVersion>
        <major>1</major>
        <minor>0</minor>
    </specVersion>
    <URLBase>http://192.168.52.182:80/</URLBase>
    <device>
        <deviceType>urn:schemas-upnp-org:device:Basic:1</deviceType>
        <friendlyName>Philips hue (192.168.52.182)</friendlyName>
        <manufacturer>Signify</manufacturer>
        <manufacturerURL>http://www.meethue.com</manufacturerURL>
        <modelDescription>Philips hue Personal Wireless Lighting</modelDescription>
        <modelName>Philips hue bridge 2015</modelName>
        <modelNumber>BSB002</modelNumber>
        <modelURL>http://www.meethue.com</modelURL>
        <serialNumber>ecb5fa923aad</serialNumber>
        <UDN>uuid:2f402f80-da50-11e1-9b23-ecb5fa923aad</UDN>
        <presentationURL>index.html</presentationURL>
        <iconList>
            <icon>
                <mimetype>image/png</mimetype>
                <height>48</height>
                <width>48</width>
                <depth>24</depth>
                <url>hue_logo_0.png</url>
            </icon>
        </iconList>
    </device>
</root>

On obtient par exemple l'adresse MAC du pont Hue, ici : ec:b5:fa:92:3a:ad

OpenHue API

Liens :

OpenHue API est un projet open source qui fournit une spécification complète pour l'API Philips Hue REST. Elle permettra de développer des applications clientes pour exploiter une installation de matériels Hue.

Télécharger le fichier de spécification openapi.yaml :

$ wget -c --output-document openapi.yaml 'https://api.redocly.com/registry/bundle/openhue/openhue/v2/openapi.yaml?branch=main&download'

$ ls -l openapi.yaml
-rw-rw-r-- 1 tv tv 120480 févr.  6 07:32 openapi.yaml

Ce fichier pourra être utilisé par une application comme Postman.

OpenHue CLI

Il existe un outil en ligne de commande OpenHue CLI (https://www.openhue.io/cli/openhue-cli) disponible via brew ou docker.

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

$ brew tap openhue/cli
$ brew install openhue-cli
$ openhue help

openhue controls your Philips Hue lighting system

    Find more information at: https://www.openhue.io/cli

Usage:
  openhue [command]

Configuration
  config      Manual openhue CLI setup
  discover    Hue Bridge discovery
  setup       Automatic openhue CLI setup

Philips Hue
  get         Display one or many resources
  set         Set specific features on resources

Additional Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  version     Print the version information

Flags:
  -h, --help   help for openhue

Use "openhue [command] --help" for more information about a command.

Il faut commencer par s'authentifier pour obtenir une clé API :

$ openhue setup
[OK] Found Hue Bridge with IP '192.168.52.182'
[..] Please push the button on your Hue Bridge
......
[OK] Successfully paired openhue with your Hue Bridge!
[OK] Configuration saved in file $HOME/.openhue/config.yaml

La clé (key) de l'API est stocké dans le fichier $HOME/.openhue/config.yaml :

$ cat $HOME/.openhue/config.yaml
bridge: 192.168.52.182
key: LiG7XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXvZ8f

Ensuite, il est possible d'interroger le pont Hue :

$ openhue get lights
...
$ docker pull openhue/cli

$ docker run -v "${HOME}/.openhue:/.openhue" --rm -it --name=openhue openhue/cli help
...

$ docker run -v "${HOME}/.openhue:/.openhue" --rm -it --name=openhue openhue/cli setup --bridge 192.168.52.182
...

$ docker run -v "${HOME}/.openhue:/.openhue" --rm -it --name=openhue openhue/cli get lights

Outils CLI

Il est évidemment d'interagir avec le pont Hue tout simplement avec les commandes curl ou wget.

Il faut commencer par s'authentifier pour obtenir une clé API :

$ curl -k --location 'https://192.168.52.182/api' --header 'Content-Type: application/json' --header 'Accept: application/json' --data '{
  "devicetype": "openhue-bts",
  "generateclientkey": true
}'
[{"error":{"type":101,"address":"","description":"link button not pressed"}}]

Il faut tout d'abord appuyer sur le bouton du pont Hue :

$ curl -k --location 'https://192.168.52.182/api' --header 'Content-Type: application/json' --header 'Accept: application/json' --data '{
  "devicetype": "openhue-bts",
  "generateclientkey": true
}'
[{"success":{"username":"XXXXXXXX","clientkey":"YYYYYYYY"}}]

Important

La clé d'API a utilisé par la suite dans les requêtes est la valeur de username !

On peut maintenant interroger le pont Hue en utilisant l'API. Pour cela, on aura besoin de connaître les détails de la spécification de l'API :

On peut commencer par récupérer l'ensemble des ressources :

$ curl -k --location 'https://192.168.52.182/clip/v2/resource' --header 'Accept: application/json' --header 'hue-application-key: XXXXXXXX'

La liste des éclairages :

$ curl -k --location 'https://192.168.52.182/clip/v2/resource/light' --header 'Accept: application/json' --header 'hue-application-key: XXXXXXXX'
{"errors":[],"data":[{"id":"5d4ba384-f49c-45a1-a68f-874a5008b967","id_v1":"/lights/3","owner":{"rid":"959b6312-3318-4379-b27a-6e1d6e076b4b","rtype":"device"},"metadata":{"name":"Hue color lamp 3","archetype":"classic_bulb","function":"mixed"},"product_data":{"function":"mixed"},"identify":{},"on":{"on":false},"dimming":{"brightness":8.3,"min_dim_level":0.20000000298023225},"dimming_delta":{},"color_temperature":{"mirek":366,"mirek_valid":true,"mirek_schema":{"mirek_minimum":153,"mirek_maximum":500}},"color_temperature_delta":{},"color":{"xy":{"x":0.4573,"y":0.41},"gamut":{"red":{"x":0.6915,"y":0.3083},"green":{"x":0.17,"y":0.7},"blue":{"x":0.1532,"y":0.0475}},"gamut_type":"C"},"dynamics":{"status":"none","status_values":["none","dynamic_palette"],"speed":0.0,"speed_valid":false},"alert":{"action_values":["breathe"]},"signaling":{"signal_values":["no_signal","on_off","on_off_color","alternating"]},"mode":"normal","effects":{"status_values":["no_effect","candle","fire","prism"],"status":"no_effect","effect_values":["no_effect","candle","fire","prism"]},"powerup":{"preset":"safety","configured":true,"on":{"mode":"on","on":{"on":true}},"dimming":{"mode":"dimming","dimming":{"brightness":100.0}},"color":{"mode":"color_temperature","color_temperature":{"mirek":366}}},"type":"light"},{"id":"a40100ed-eedf-4f8b-b5f9-271b790edb2f","id_v1":"/lights/2","owner":{"rid":"73138873-8a25-460f-a48d-b05ad72dd5f7","rtype":"device"},"metadata":{"name":"Hue color lamp 2","archetype":"classic_bulb","function":"mixed"},"product_data":{"function":"mixed"},"identify":{},"on":{"on":false},"dimming":{"brightness":100.0,"min_dim_level":0.20000000298023225},"dimming_delta":{},"color_temperature":{"mirek":366,"mirek_valid":true,"mirek_schema":{"mirek_minimum":153,"mirek_maximum":500}},"color_temperature_delta":{},"color":{"xy":{"x":0.4573,"y":0.41},"gamut":{"red":{"x":0.6915,"y":0.3083},"green":{"x":0.17,"y":0.7},"blue":{"x":0.1532,"y":0.0475}},"gamut_type":"C"},"dynamics":{"status":"none","status_values":["none","dynamic_palette"],"speed":0.0,"speed_valid":false},"alert":{"action_values":["breathe"]},"signaling":{"signal_values":["no_signal","on_off","on_off_color","alternating"]},"mode":"normal","effects":{"status_values":["no_effect","candle","fire","prism"],"status":"no_effect","effect_values":["no_effect","candle","fire","prism"]},"powerup":{"preset":"safety","configured":true,"on":{"mode":"on","on":{"on":true}},"dimming":{"mode":"dimming","dimming":{"brightness":100.0}},"color":{"mode":"color_temperature","color_temperature":{"mirek":366}}},"type":"light"},{"id":"f4d936da-441d-46d5-bf58-0089ad4a9aa9","id_v1":"/lights/1","owner":{"rid":"02f7b76f-9365-49be-856e-7ab553d94adb","rtype":"device"},"metadata":{"name":"Hue color lamp 1","archetype":"classic_bulb","function":"mixed"},"product_data":{"function":"mixed"},"identify":{},"on":{"on":false},"dimming":{"brightness":8.3,"min_dim_level":0.20000000298023225},"dimming_delta":{},"color_temperature":{"mirek":366,"mirek_valid":true,"mirek_schema":{"mirek_minimum":153,"mirek_maximum":500}},"color_temperature_delta":{},"color":{"xy":{"x":0.4573,"y":0.41},"gamut":{"red":{"x":0.6915,"y":0.3083},"green":{"x":0.17,"y":0.7},"blue":{"x":0.1532,"y":0.0475}},"gamut_type":"C"},"dynamics":{"status":"none","status_values":["none","dynamic_palette"],"speed":0.0,"speed_valid":false},"alert":{"action_values":["breathe"]},"signaling":{"signal_values":["no_signal","on_off","on_off_color","alternating"]},"mode":"normal","effects":{"status_values":["no_effect","candle","fire","prism"],"status":"no_effect","effect_values":["no_effect","candle","fire","prism"]},"powerup":{"preset":"safety","configured":true,"on":{"mode":"on","on":{"on":true}},"dimming":{"mode":"dimming","dimming":{"brightness":100.0}},"color":{"mode":"color_temperature","color_temperature":{"mirek":366}}},"type":"light"}]}

Obtenir les détails d'un éclairage avec son identifiant {lightId} :

curl -k --location 'https://192.168.52.182/clip/v2/resource/light/f4d936da-441d-46d5-bf58-0089ad4a9aa9' --header 'Accept: application/json' --header 'hue-application-key: XXXXXXXX'
{"errors":[],"data":[{"id":"f4d936da-441d-46d5-bf58-0089ad4a9aa9","id_v1":"/lights/1","owner":{"rid":"02f7b76f-9365-49be-856e-7ab553d94adb","rtype":"device"},"metadata":{"name":"Hue color lamp 1","archetype":"classic_bulb","function":"mixed"},"product_data":{"function":"mixed"},"identify":{},"on":{"on":false},"dimming":{"brightness":8.3,"min_dim_level":0.20000000298023225},"dimming_delta":{},"color_temperature":{"mirek":366,"mirek_valid":true,"mirek_schema":{"mirek_minimum":153,"mirek_maximum":500}},"color_temperature_delta":{},"color":{"xy":{"x":0.4573,"y":0.41},"gamut":{"red":{"x":0.6915,"y":0.3083},"green":{"x":0.17,"y":0.7},"blue":{"x":0.1532,"y":0.0475}},"gamut_type":"C"},"dynamics":{"status":"none","status_values":["none","dynamic_palette"],"speed":0.0,"speed_valid":false},"alert":{"action_values":["breathe"]},"signaling":{"signal_values":["no_signal","on_off","on_off_color","alternating"]},"mode":"normal","effects":{"status_values":["no_effect","candle","fire","prism"],"status":"no_effect","effect_values":["no_effect","candle","fire","prism"]},"powerup":{"preset":"safety","configured":true,"on":{"mode":"on","on":{"on":true}},"dimming":{"mode":"dimming","dimming":{"brightness":100.0}},"color":{"mode":"color_temperature","color_temperature":{"mirek":366}}},"type":"light"}]}

// ou :
wget --no-check-certificate --quiet --method GET --timeout=0 --header 'Accept: application/json' --header 'hue-application-key: XXXXXXXX' 'https://192.168.52.182/clip/v2/resource/light/f4d936da-441d-46d5-bf58-0089ad4a9aa9'

En utilisant une requête PUT, il sera alors possible de mettre à jour l'état d'un éclairage, ici ON/OFF :

$ wget --no-check-certificate --quiet  --method PUT  --timeout=0   --header 'Content-Type: application/json'   --header 'Accept: application/json'   --header 'hue-application-key: XXXXXXXX' --body-data '{  "on": {    "on": false  }}'    'https://192.168.52.182/clip/v2/resource/light/f4d936da-441d-46d5-bf58-0089ad4a9aa9'

$ wget --no-check-certificate --quiet  --method PUT  --timeout=0   --header 'Content-Type: application/json'   --header 'Accept: application/json'   --header 'hue-application-key: XXXXXXXX' --body-data '{  "on": {    "on": true  }}'    'https://192.168.52.182/clip/v2/resource/light/f4d936da-441d-46d5-bf58-0089ad4a9aa9'

Postman

Postman est une plateforme pour la construction, l'utilisation et les tests d'API.

Lien : https://www.postman.com/

Télécharger et installer la version de Postman pour Linux : https://dl.pstmn.io/download/latest/linux_64

Ou à partir du gestionnaire de paquets snap :

$ sudo snap install postman

Créer un compte si nécessaire (ici, campus-btssn-avignon).

Il existe aussi un outil en ligne de commande Postman CLI :

$ curl -o- "https://dl-cli.pstmn.io/install/linux64.sh" | sh

Il existe une extension pour Visual Studio Code : https://marketplace.visualstudio.com/items?itemName=Postman.postman-for-vscode

Créer un nouvel environnement avec ces deux variables :

  • baseUrl avec comme valeur initiale et courante l'adresse du pont Hue, par exemple : https://192.168.52.182
  • apiKey avec comme valeur initiale et courante la valeur username obtenue ou à obtenir par une phase d'authentification

La liste des éclairages :

Application cliente

Pour faire simple, cela revient à émettre des requêtes HTTP et traiter du JSON.

Générateur

Des utilitaires comme Postman fournissent des extraits de code à réutiliser :

Par exemple pour Java :

Il existe aussi OpenAPI Generator qui permet la génération de bibliothèques clientes d'API HTTP avec une spécification OpenAPI.

OpenAPI est une norme de description des API HTTP conformes à l’architecture REST. La spécification OpenAPI actuelle découle d’un projet antérieur nommé Swagger (cf. https://www.ionos.fr/digitalguide/sites-internet/developpement-web/quest-ce-que-openapi/).

Liens :

Instalation :

$ npm install -g @openapitools/openapi-generator-cli

npx openapi-generator-cli version
Did set selected version to 7.1.0
7.1.0

Génération de code Python :

$ npx @openapitools/openapi-generator-cli generate -g python -i https://api.redocly.com/registry/bundle/openhue/openhue/v2/openapi.yaml -o my-openhue-project

Android Java

Pour émettre des requêtes HTTP sous Android, il y a plusieurs possibilités. Ici, on utilisera le client HTTP OkHttp.

On pourrait aussi utiliser le client HTTP de l'API Google.

Pour utiliser OkHttp, il faut tout d'abord ajouter dans le fichier app/build.gradle :

dependencies {
    ...
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    ...
}

Dans le code source java, il faut préalablement importer les différentes classes utiles pour émettre des requêtes HTTP :

import okhttp3.Call;
import okhttp3.Callback;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;

Pour émettre des requêtes HTTPS, il va être nécessaire d'accepter (tous) les certificats SSL :

import java.security.KeyManagementException;
import java.security.NoSuchAlgorithmException;

import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.X509TrustManager;

import okhttp3.OkHttpClient;

public class TrustAllCertsClient {
    public static OkHttpClient getTrustAllCertsClient() throws NoSuchAlgorithmException, KeyManagementException {
        TrustManager[] trustAllCerts = new TrustManager[]{
                new X509TrustManager() {
                    @Override
                    public void checkClientTrusted(java.security.cert.X509Certificate[] chain, String authType) {
                    }

                    @Override
                    public void checkServerTrusted(java.security.cert.X509Certificate[] chain, String authType) {
                    }

                    @Override
                    public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                        return new java.security.cert.X509Certificate[]{};
                    }
                }
        };

        SSLContext sslContext = SSLContext.getInstance("SSL");
        sslContext.init(null, trustAllCerts, new java.security.SecureRandom());

        OkHttpClient.Builder newBuilder = new OkHttpClient.Builder();
        newBuilder.sslSocketFactory(sslContext.getSocketFactory(), (X509TrustManager) trustAllCerts[0]);
        newBuilder.hostnameVerifier((hostname, session) -> true);
        return newBuilder.build();
    }
}

On commence par instancier un objet de type OkHttpClient :

OkHttpClient clientOkHttp      = null;

try
{
    clientOkHttp = TrustAllCertsClient.getTrustAllCertsClient();
}
catch(NoSuchAlgorithmException e)
{
    throw new RuntimeException(e);
}
catch(KeyManagementException e)
{
    throw new RuntimeException(e);
}

Et pour émettre une requête GET :

String url = "https://discovery.meethue.com/";
Request request = new Request.Builder().url(url).addHeader("Content-Type", "application/json").build();

clientOkHttp.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e)
    {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException
    {
        Log.d(TAG, "onResponse - message = " + response.message());
        Log.d(TAG, "onResponse - code    = " + response.code());

        if(!response.isSuccessful())
        {
            throw new IOException(response.toString());
        }

        final String body = response.body().string();
        Log.d(TAG, "onResponse - body    = " + body);
    }
});

Et pour émettre une requête GET avec une clé d'API:

String adresseIPPontHue = "192.168.52.187";
String hueApplicationKey = "XXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
String url = "https://" + adresseIPPontHue + "/clip/v2/resource/light";
Request request = new Request.Builder()
                            .url(url)
                            .addHeader("Content-Type", "application/json")
                            .addHeader("hue-application-key", hueApplicationKey)
                            .build();

clientOkHttp.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e)
    {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException
    {
        Log.d(TAG, "onResponse - message = " + response.message());
        Log.d(TAG, "onResponse - code    = " + response.code());

        if(!response.isSuccessful())
        {
            throw new IOException(response.toString());
        }

        final String body = response.body().string();
        Log.d(TAG, "onResponse - body    = " + body);

        //@todo traiter le JSON ...
    }
});

Et pour émettre une requête POST :

String adresseIPPontHue = "192.168.52.187";
String url = "https://" + adresseIPPontHue + "/api/";
MediaType   JSON     = MediaType.parse("application/json; charset=utf-8");
String      jsonBody = "{\"devicetype\": \"" + TAG + "\",\"generateclientkey\": true}";
RequestBody body     = RequestBody.create(JSON, jsonBody);

Request request = new Request.Builder()
                    .url(url)
                    .post(body)
                    .addHeader("Content-Type", "application/json")
                    .addHeader("Accept", "application/json")
                    .build();

...

Ou pour émettre une requête PUT avec des données JSON :

String adresseIPPontHue = "192.168.52.187";
String hueApplicationKey = "XXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
String id = "f9a9b376-6738-4bd1-81ce-021e2ee56a82";
String url = "https://" + adresseIPPontHue + "/clip/v2/resource/light/" + id;
MediaType   JSON     = MediaType.parse("application/json; charset=utf-8");
String      jsonBody = "{\"on\":{\"on\": true}}";
RequestBody body     = RequestBody.create(JSON, jsonBody);

Request request = new Request.Builder()
                    .url(url)
                    .put(body)
                    .addHeader("Content-Type", "application/json")
                    .addHeader("Accept", "application/json")
                    .addHeader("hue-application-key", hueApplicationKey)
                    .build();

clientOkHttp.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e)
    {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException
    {
        Log.d(TAG, "onResponse - message = " + response.message());
        Log.d(TAG, "onResponse - code    = " + response.code());

        if(!response.isSuccessful())
        {
            throw new IOException(response.toString());
        }

        final String body = response.body().string();
        Log.d(TAG, "onResponse - body    = " + body);
    }
});

Un exemple d'application Android "basique" est fourni dans src/android/MyApplicationHTTP/ :

Qt C++

Pour émettre des requêtes HTTP sous Qt, il faudra utiliser la classe QNetworkAccessManager.

Il faut tout d'abord activer le module network dans le fichier de projet .pro pour accéder aux classes :

QT += network

Il faut ensuite accéder aux déclarations des classes :

#include <QtNetwork/QNetworkAccessManager>
#include <QNetworkReply>

On commence par instancier un objet de type QNetworkAccessManager :

QNetworkAccessManager* accesReseau = new QNetworkAccessManager(this);

Il faut ensuite connecter le signal finished() à un slot qui permettra de traiter la réponse à une requête :

connect(accesReseau,
        SIGNAL(finished(QNetworkReply*)),
        this,
        SLOT(traiterReponseHue(QNetworkReply*)));

Émettre une requête GET :

QUrl            url = QUrl("https://discovery.meethue.com/");
QNetworkRequest requeteGet;
requeteGet.setUrl(url);
requeteGet.setRawHeader("Content-Type", "application/json");
accesReseau->get(requeteGet);

Le slot sera automatiquement appelé lorsque la réponse sera reçue :

void MyApplicationHTTP::traiterReponseHue(QNetworkReply* reponse)
{
    if(reponse->error() != QNetworkReply::NoError)
    {
        qDebug() << Q_FUNC_INFO << "erreur" << reponse->error();
        qDebug() << Q_FUNC_INFO << "erreur" << reponse->errorString();
        return;
    }
    QByteArray donneesReponse = reponse->readAll();
    qDebug() << Q_FUNC_INFO << "donneesReponse" << donneesReponse;
    ...
    // @todo traiter les données JSON
}

Émettre une requête GET avec une clé d'API :

QString         api = "https://" + adresseIPPontHue + "/clip/v2/resource/light";
QUrl            url = QUrl(api);
QNetworkRequest requeteGet;
requeteGet.setUrl(url);
requeteGet.setRawHeader("Content-Type", "application/json");
requeteGet.setRawHeader("hue-application-key", hueApplicationKey.toLocal8Bit());
// Pour émettre des requêtes HTTPS, il va être nécessaire d'accepter (tous) les certificats SSL
QSslConfiguration conf = requeteGet.sslConfiguration();
conf.setPeerVerifyMode(QSslSocket::VerifyNone);
requeteGet.setSslConfiguration(conf);
accesReseau->get(requeteGet);

Émettre une requête POST :

QString         api = "https://" + adresseIPPontHue + "/api";
QNetworkRequest requetePost;
QUrl            url  = QUrl(api);
QByteArray      json = "{\"devicetype\": \"ClientHTTPHue\",\"generateclientkey\": true}";
requetePost.setUrl(url);
requetePost.setHeader(QNetworkRequest::ContentTypeHeader, "application/x-www-form-urlencoded");
requetePost.setRawHeader("Content-Type", "application/json");
requetePost.setRawHeader("Content-Length", QByteArray::number(json.size()));
requetePost.setRawHeader("Accept", "application/json");
// Pour émettre des requêtes HTTPS, il va être nécessaire d'accepter (tous) les certificats SSL
QSslConfiguration conf = requetePost.sslConfiguration();
conf.setPeerVerifyMode(QSslSocket::VerifyNone);
requetePost.setSslConfiguration(conf);
accesReseau->post(requetePost, json);

Ou pour émettre une requête PUT avec des données JSON :

QString         id  = "f9a9b376-6738-4bd1-81ce-021e2ee56a82";
QString         api = "https://" + adresseIPPontHue + "/clip/v2/resource/light/" + id;
QNetworkRequest requetePut;
QUrl            url  = QUrl(api);
QByteArray      json = "{\"on\":{\"on\": true}}";
requetePut.setUrl(url);
requetePut.setRawHeader("Content-Type", "application/json");
requetePut.setRawHeader("Accept", "application/json");
requetePut.setRawHeader("hue-application-key", hueApplicationKey.toLocal8Bit());
// Pour émettre des requêtes HTTPS, il va être nécessaire d'accepter (tous) les certificats SSL
QSslConfiguration conf = requetePut.sslConfiguration();
conf.setPeerVerifyMode(QSslSocket::VerifyNone);
requetePut.setSslConfiguration(conf);
accesReseau->put(requetePut, json);

Un exemple d'application Qt "basique" est fourni dans src/qt/ :

Python

  • Avec http.client :
import http.client

conn = http.client.HTTPSConnection("192.168.52.187")
payload = ''
headers = {
  'Accept': 'application/json',
  'hue-application-key': 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
}
conn.request("GET", "/clip/v2/resource/light/f9a9b376-6738-4bd1-81ce-021e2ee56a82", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
  • Avec requests :
import requests

url = "https://187/clip/v2/resource/light/f9a9b376-6738-4bd1-81ce-021e2ee56a82"

payload = {}
headers = {
  'Accept': 'application/json',
  'hue-application-key': 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Boutique

Auteur

© 2024 LaSalle Avignon

About

Gestion d'un éclairage connecté Philips Hue via l'API Philips Hue REST

Topics

android qt5 api-rest

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages