API IJENKO - Données de comptage - Comment récupérer les données de consommation globale d'un foyer en HC/HP?

Je souhaite récupérer les données de consommation globale d’un des foyers anonymes, avec le détail Heures creuses / Heures pleines.
Quelle requête utiliser avec quels paramètres ?

Pour récupérer les données de consommation globale 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 l’identifiant de la fonctionnalité de comptage global.

GET <URL>/places/<placeId>/functionalities?functionalities=ij:total_usage&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": "4CJKy9XPYOZXQL6cA4m4tQ",
   "class": "ElecSmartMetering",
   "endpoint": 10,
   "tags": ["ij:total_usage"]
 }]

1. Données de consommation Wh répartis entre HC/HP - format horaire

GET <URL>/functionalities/<functionalityId>/attributes?names=HourSummEnergyPeriod2,HourSummPriceEnergy3&from=2016-04-05T16:59:59Z&to=2016-04-05T19:59:59Z&token=<token>

// <URL> à remplacer par l’URL de l’API
// <functionalityId> à remplacer par l’identifiant de la fonctionnalité de comptage avec tag « total_usage » récupérée avec l’appel décrit ci-haut
// <token> à remplacer par le token fourni par IJENKO à l’équipe.
// le filtre from indique la date à partir de laquelle on veut récupérer l’historique (optionnel), au format AAAA-MM-DDT00:00:59Z
// le filtre to indique la date à la fin de laquelle on veut récupérer l’historique (optionnel), au format AAAA-MM-DDT00:00:59Z
// Si les filtres ne sont pas fournis alors on récupère tout l’historique jusqu’à la date courante. Dans l’exemple fourni, on récupère les 24 données horaires du 12 Avril 2016.

La réponse a le format suivant - Données factices fournies en exemple :
ATTENTION : LE TIMESTAMP EST AU FORMAT UTA => DECALAGE POUR PARIS EN GMT+1 ou GMT+2
Les données sont en Wh(et non kWh)

{
 "HourSummEnergyPeriod2": [  // Les données en Heure creuse (Period1)
   {
     "value": "0",
     "when": "2016-04-05T16:59:59Z" // Données entre 19h et 20h - Heure pleine => valeur nulle
   },
   {
     "value": "0",
     "when": "2016-04-05T17:59:59Z" // Données entre 20h et 21h - Heure pleine => valeur nulle
   },
   {
     "value": "0",
     "when": "2016-04-05T18:59:59Z" // Données entre 21h et 22h - Heure pleine => valeur nulle
   },
   {
     "value": "3",
     "when": "2016-04-05T19:59:59Z" // Données entre 22h et 23h - Heure pleine + Heure creuse
   }
 ],
 "HourSummEnergyPeriod3": [ // Les données en Heure pleine (Period2)
   {
     "value": "4",
     "when": "2016-04-05T16:59:59Z" // Données entre 19h et 20h - Heure pleine => valeur non nulle
   },
   {
     "value": "4",
     "when": "2016-04-05T17:59:59Z" // Données entre 20h et 21h - Heure pleine => valeur non nulle
   },
   {
     "value": "4",
     "when": "2016-04-05T18:59:59Z" // Données entre 21h et 22h - Heure pleine => valeur non nulle
   },
   {
     "value": "3",
     "when": "2016-04-05T19:59:59Z" // Données entre 22h et 23h - Heure pleine + Heure creuse
   } ] }

L’exemple ci-haut fournit la répartition de la consommation entre heure creuse (Period2) et heure pleine (Period3).

2. Données de consommation Wh ou € répartis entre HC/HP - format journalier

GET <URL>/functionalities/<functionalityId>/attributes?names=DaySummEnergyPeriod2,DaySummEnergyPeriod3&from=2016-04-05T16:59:59Z&to=2016-04-05T19:59:59Z&token=<token>

ou

GET <URL>/functionalities/<functionalityId>/attributes?names=DaySummPricePeriod2,DaySummPricePeriod3&from=2016-04-05T16:59:59Z&to=2016-04-05T19:59:59Z&token=<token>

2. Données de consommation Wh ou € répartis entre HC/HP - format mensuel

GET <URL>/functionalities/<functionalityId>/attributes?names=MonthSummEnergyPeriod2,MonthSummEnergyPeriod3&from=2016-04-05T16:59:59Z&to=2016-04-05T19:59:59Z&token=<token>

ou

GET <URL>/functionalities/<functionalityId>/attributes?names=MonthSummPricePeriod2,MonthSummPricePeriod3&from=2016-04-05T16:59:59Z&to=2016-04-05T19:59:59Z&token=<token>