API IJENKO - Données de comptage - Comment récupérer les données de consommation d'un appareil du foyer ?

Je souhaite récupérer les données d’un appareil électrique d’un foyer parmi la liste des foyers anonymes mis à disposition.
Quelles requêtes utiliser et avec quels paramètres ?

Pour récupérer les données de consommation par usage d’un foyer, il faut récupérer l’identifiant du foyer.
Il s’agit du placeId => voir la discussion « https://forum.etalab.gouv.fr/t/api-ijenko-donnees-de-comptage-comment-acceder-aux-donnees-dun-foyer » pour récupérer le placeId.

=> Faire l’appel suivant pour récupérer toutes les fonctionnalités de comptage (dont les appareils électriques) disponibles.

GET <URL>/places/<placeId>/functionalities?functionalities=ElecMetering&token=<token>

// <URL> à remplacer par l’URL de l’API
// <placeId> à remplacer par l’identifiant du foyer tel indique ci-dessus
// <token> à remplacer par le token fourni par IJENKO à l’équipe.

La réponse a le format suivant:

[
     {
       "id": "54Aay9XPYMQFQJ6cA7m4yA", // il s'agit du functionalityId qu'il faut utiliser dans les appels suivants
       "device": "dfsKy9XPYOZXQL6cA4m4tQ",
       "class": "ElecMetering",
       "endpoint": 10,
       "tags": ["ij:total_usage"] // Le tag indique qu'il s'agit de la consommation globale
     },
    {
       "id": "sfdqsfdsfqsfFQJ6cA7m4yA", // il s'agit du functionalityId qu'il faut utiliser dans les appels suivants
       "device": "sdfsdf9XPYOZXQL6cA4m4tQ",
       "class": "ElecMetering",
       "endpoint": 1,
       "tags": ["ij:use_heating"] // Le tag indique qu'il s'agit d'un radiateur électrique
     },
     {
       "id": "qsdfsdfsdfXPYMQFQJ6cA7m4yA", // il s'agit du functionalityId qu'il faut utiliser dans les appels suivants
       "device": "4CJKy9XPYsdfsdfsqdf4m4tQ",
       "class": "ElecMetering",
       "endpoint": 2,
       "tags": ["ij:use_hot_water"] // Le tag indique qu'il s'agit du ballon d'eau chaude
     }
]

Les usages disponibles sont :
ij:use_media -> Audiovisuel
ij:use_other -> Autre
ij:use_heating -> Chauffage électrique
ij:use_cooling -> Climatisation
ij:use_cooking -> Cuisine
ij:use_misc -> Divers
ij:use_lighting -> Eclairage
ij:use_hot_water -> Eau chaude sanitaire
ij:use_cold -> Froid
ij:use_computer -> Informatique
ij:use_laundry -> Lavage, séchage et entretien

En fonction du tag, on identifie de quel type d’appareil électrique il s’agit. Choisir le bon functionalityId pour récupérer les données de l’appareil souhaité.

Les formats des services API sont identiques que pour récupérer la consommation globale.
Voir les autres sujets de discussion sur la consommation globale kWh / Euros / CO2, granularité Horaire, journalière ou mensuelle, et en répartition HC/HP.