Documentation de service Web / Catégories / Services de compteur / Get ID Hierarchy for Consumption Data (Obtenir l'identifiant de la hiérarchie pour les données de consommation)

Get ID Hierarchy for Consumption Data (Obtenir l'identifiant de la hiérarchie pour les données de consommation)

Mise à jour le 22 février 2021

Description

Ce service Web renvoie les identifiants d’un compte, d’une propriété et d’un compteur qui correspondent à une fiche précise de données sur la consommation. L’identifiant du compte est l’administrateur des données de la propriété (ADP). Si la fiche de données sur la consommation fait référence à un compteur TI ou à un débitmètre, le message renvoie également l’identifiant de l’utilisation de la propriété associé au compteur; sinon, il est omis. Vous devez cependant déjà être autorisé pour le partage ou être en attente d’une telle autorisation concernant le compteur correspondant.

Version

22.0

Méthode HTTP

GET

URL de la ressource

/idHierarchy/consumptionData/(consumptionDataId)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
consumptionDataId Identifiant de la fiche de consommation pour récupérer la hiérarchie

Schémas XML

Demande/réponse Nom de schéma
Demande Aucun
Réponse hierarchy.xsd

Exemple de demande

L'exemple qui suit récupère la hiérarchie pour la fiche de consommation dont l'identifiant est 789.

GET  /idHierarchy/consumptionData/789

Exemple de réponse

L’exemple suivant renvoie les identifiants d’un compte, d’une propriété et d’un compteur pour une fiche de données sur la consommation dont l’identifiant est 789. En outre dans cet exemple, les données sur la consommation indiquées dans la fiche font référence à un compteur TI, donc le message renvoie également l’identifiant de l’utilisation de la propriété (le centre de données) auquel le compteur TI est associé, sinon il est omis.

<?xml version="1.0" encoding="UTF-8"?>
<hierarchy>
     <accountId>987</accountId>
     <username>johndoe</username>
     <propertyId>345</propertyId>
     <propertyUseId>246</propertyUseId>
     <meterId>456</meterId>
     <consumptionDataId>789</consumptionDataId>
</hierarchy>
ENVIRONNEMENT DE PRODUCTION