Documentation de service Web / Catégories / Services de compteur / Obtenir les modifications apportées à la liste d’utilisations de propriété
Mise à jour le 26 février 2024
Ce service Web permet de renvoyer une liste de compteurs d’une propriété précise qui ont changé depuis une date spécifiée par un utilisateur. Les compteurs de la liste renvoyée sont spécifiques à la propriété. La liste renvoyée montre uniquement les compteurs que vous êtes autorisés à voir. Les résultats sont envoyés par paliers de 1000 par série. Les actions qui entraînent l’inclusion d’un compteur dans la liste renvoyée ont pu être effectuées par n’importe quel utilisateur ayant accès au compteur. Une liste d’actions des utilisateurs qui entraînent l’inclusion d’un compteur dans la liste renvoyée est disponible ici.
22.0
GET
/property/(propertyId)/meter/whatChanged?date=(YYYY-MM-DD)
Nom du champ | Valeur | Commentaires |
---|---|---|
Autorisation | Basic authentifiant |
Oui
Nom du paramètre | Description |
---|---|
date | Indique la date de début de la période visée. Doit être une date valide dans le format AAAA-MM-DD. La date de fin de la période visée correspond à la date actuelle. La date de fin ne peut pas être modifiée. |
nextPageKey | Facultatif. Cet élément sert de référence pour la détermination des résultats à inclure à la prochaine page. Il n'est pas un numéro de page. Il n'est généralement pas inclus dans l'appel initial et est fourni si les résultats sont paginés. |
previousPageKey | Facultatif. Cet élément sert de référence pour la détermination des résultats à inclure à la page précédente. Il n'est pas un numéro de page. Il n'est généralement pas inclus dans l'appel initial et est fourni si les résultats sont paginés. |
propertyId | Identifiant de la propriété |
Demande/réponse | Nom de schéma |
---|---|
Demande | Aucun |
Réponse | response.xsd |
L’exemple suivant permet d’extraire la deuxième page d’une liste d’utilisations de propriété qui ont changé depuis le 31 juillet 2010. Ces utilisations de propriété sont destinées au client qui a un identifiant de 100.
GET /property/100/meter/whatChanged?nextPageKey=3000&date=2010-07-31
L'exemple qui suit récupère une liste de compteurs appartenant à un propriété est 100 qui ont été modifiés depuis le 31 juillet 2010. La liste contient des liens vers des services Web dont vous pouvez vous servir pour récupérer des informations sur chaque compteur.
<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
<links>
<link id="861" httpMethod="GET" link="/meter/861" linkDescription="This is the GET url for this Meter." hint="Electric Meter"/>
<link id="341" httpMethod="GET" link="/meter/341" linkDescription="This is the GET url for this Meter." hint="NG Meter"/>
<link httpMethod="GET" link="/property/100/meter/whatChanged?nextPageKey=4000&date=2010-07-31" linkDescription="next page"/>
<link httpMethod="GET" link="/property/100/meter/whatChanged?previousPageKey=3000&date=2010-07-31" linkDescription="previous page"/>
</links>
</response>
Une liste sans compteurs est affichée. Aucun compteur a été modifié.
<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
<links/>
</response>