Documentation de service Web / Catégories / Services de compteur / Get Meter Consumption Data (Récupérer les données de consommation du compteur)
Mise à jour le 14 août 2017
Ce service Web récupère les données de consommation d'un compteur particulier. Le compteur doit déjà être partagé avec vous. Les données de consommation sont affichées par ensembles de 120 résultats. Facultativement, on peut préciser une gamme de dates pour récupérer un ensemble particulier de fiches de consommation.
22.0
GET
/meter/(meterId)/consumptionData?page=(page)&startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD)
Nom du champ | Valeur | Commentaires |
---|---|---|
Autorisation | Basic authentifiant |
Oui
Nom du paramètre | Description |
---|---|
endDate | Facultatif. Indique la date de fin d'une gamme de dates personnalisée pour la récupération des données de consommation. Doit être une date valide, dans le format AAAA-MM-JJ. |
meterId | Identifiant du compteur |
page | Facultatif. Indique l'ensemble de résultats, défini par numéro de page, à récupérer. Ce paramètre n'est généralement pas inclus dans l'appel initial, et est fourni si les résultats sont paginés. |
startDate | Facultatif. Indique la date de début d'une gamme de dates personnalisée pour la récupération des données de consommation. Doit être une date valide, dans le format AAAA-MM-JJ. |
Demande/réponse | Nom de schéma |
---|---|
Demande | Aucun |
Réponse | meterConsumptionData.xsd |
L'exemple suivant montre la récupération des données de consommation pour un compteur dont l'identifiant correspond à 100. Pour récupérer seulement les fiches de consommation pour la période entre le 1 janvier 2011 et le 31 décembre 2011, vous devez fournir les paramètres URL suivants : startDate=2011-01-01&endDate=2011-12-31
GET /meter/100/consumptionData
L'exemple suivant affiche le premier ensemble de 120 fiches de consommation pour un compteur configuré pour les mesure précises et fournit un lien vers le prochain ensemble. Pour cet exemple, on suppose que plus de 120 fiches soient récupérées.
<?xml version="1.0" encoding="UTF-8"?>
<meterData>
<meterConsumption estimatedValue="false">
<id>-19</id>
<audit>
<createdBy>DUNAYT</createdBy>
<createdByAccountId>-14</createdByAccountId>
<createdDate>2012-05-25T09:59:06-04:00</createdDate>
<lastUpdatedBy>DUNAYT</lastUpdatedBy>
<lastUpdatedByAccountId>-14</lastUpdatedByAccountId>
<lastUpdatedDate>2012-05-26T09:59:06-04:00</lastUpdatedDate>
</audit>
<startDate>2011-07-09</startDate>
<endDate>2011-08-08</endDate>
<usage>638021</usage>
</meterConsumption>
<meterConsumption estimatedValue="false">
<id>-18</id>
<audit>
<createdBy>DUNAYT</createdBy>
<createdByAccountId>-14</createdByAccountId>
<createdDate>2012-05-25T09:59:06-04:00</createdDate>
<lastUpdatedBy>DUNAYT</lastUpdatedBy>
<lastUpdatedByAccountId>-14</lastUpdatedByAccountId>
<lastUpdatedDate>2012-05-25T09:59:06-04:00</lastUpdatedDate>
</audit>
<startDate>2011-06-09</startDate>
<endDate>2011-07-09</endDate>
<usage>625291</usage>
</meterConsumption>
<meterConsumption estimatedValue="false">
<id>-17</id>
<audit>
<createdBy>DUNAYT</createdBy>
<createdByAccountId>-14</createdByAccountId>
<createdDate>2012-05-25T09:59:06-04:00</createdDate>
<lastUpdatedBy>DUNAYT</lastUpdatedBy>
<lastUpdatedByAccountId>-14</lastUpdatedByAccountId>
<lastUpdatedDate>2012-05-25T09:59:06-04:00</lastUpdatedDate>
</audit>
<startDate>2011-05-10</startDate>
<endDate>2011-06-09</endDate>
<usage>610219</usage>
</meterConsumption>
...
<links>
<link httpMethod="get" link="/meter/100/consumptionData?page=2" linkDescription="next page"/>
</links>
</meterData>
L'exemple ci-dessous récupère le premier ensemble de 120 fiches de livraison pour un compteur configuré pour la livraison en vrac, et fournit un lien vers le prochain ensemble. Pour cet exemple, on suppose que plus de 120 fiches soient récupérées.
<?xml version="1.0" encoding="UTF-8"?>
<meterData>
<meterDelivery estimatedValue="false">
<id>-40</id>
<audit>
<createdBy>DUNAYT</createdBy>
<createdByAccountId>-14</createdByAccountId>
<createdDate>2012-05-25T09:59:06-04:00</createdDate>
<lastUpdatedBy>DUNAYT</lastUpdatedBy>
<lastUpdatedByAccountId>-14</lastUpdatedByAccountId>
<lastUpdatedDate>2012-05-26T09:59:06-04:00</lastUpdatedDate>
</audit>
<deliveryDate>2010-02-22</deliveryDate>
<quantity>1400</quantity>
</meterDelivery>
<meterDelivery estimatedValue="false">
<id>-43</id>
<audit>
<createdBy>DUNAYT</createdBy>
<createdByAccountId>-14</createdByAccountId>
<createdDate>2012-05-25T09:59:06-04:00</createdDate>
<lastUpdatedBy>DUNAYT</lastUpdatedBy>
<lastUpdatedByAccountId>-14</lastUpdatedByAccountId>
<lastUpdatedDate>2012-05-25T09:59:06-04:00</lastUpdatedDate>
</audit>
<deliveryDate>2011-01-05</deliveryDate>
<quantity>1000</quantity>
</meterDelivery>
<meterDelivery estimatedValue="false">
<id>-41</id>
<audit>
<createdBy>DUNAYT</createdBy>
<createdByAccountId>-14</createdByAccountId>
<createdDate>2012-05-25T09:59:06-04:00</createdDate>
<lastUpdatedBy>DUNAYT</lastUpdatedBy>
<lastUpdatedByAccountId>-14</lastUpdatedByAccountId>
<lastUpdatedDate>2012-05-25T09:59:06-04:00</lastUpdatedDate>
</audit>
<deliveryDate>2010-03-15</deliveryDate>
<quantity>800</quantity>
</meterDelivery>
...
<links>
<link httpMethod="get" link="/meter/101/consumptionData?page=2" linkDescription="next page"/>
</links>
</meterData>