announcement

There has been a lapse in Environmental Protection Agency appropriations. EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. If you submit a question, application, or request to EPA, it may not be processed during this period.

Documentation de service Web / Catégories / Services d'utilisation de la propriété / Obtenir l'historique des révisions des détails de l'utilisation personnalisé

Obtenir l'historique des révisions des détails de l'utilisation personnalisé

Mise à jour le 28 août 2023

Description

Ce service Web permet d'extraire l'historique des révisions des détails de l'usage personnalisé d'une propriété particulière. La propriété correspondante doit déjà être partagée avec vous.

Version

25.0

Méthode HTTP

GET

URL de la ressource

/customUse/(propertyId)/detailRevisions?currentAsOfStart=(YYYY-MM-DD)&currentAsOfEnd=(YYYY-MM-DD)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
propertyId Identifiant de la propriété

Schémas XML

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

Exemple de demande

L'exemple suivant permet d'extraire les renseignements sur l'utilisation personnalisé d'une propriété dont l'identifiant est 14. Si vous souhaitez uniquement extraire les enregistrements de détails d'utilisation couvrant une période allant du 1er janvier 2002 au 31 décembre 2002, vous devez fournir les paramètres URL suivants : currentAsOfStart=2002-01-01¤tAsOfEnd=2002-12-31

GET  /customUse/14/detailRevisions

Exemple de réponse

L'exemple suivant renvoie les renseignements sur l'tilisation personnalisé de la propriété indiquée.

<?xml version="1.0" encoding="UTF-8"?>
<useDetails>
     <customUseDetail1 dataType="numeric" id="130086500" currentAsOf="2000-01-01" temporary="false" default="No">
          <customName>test detail</customName>
          <value>55</value>
     </customUseDetail1>
     <customUseDetail1 dataType="numeric" id="130086600" currentAsOf="2005-01-01" temporary="false" default="No">
          <customName>test detail</customName>
          <value>90</value>
     </customUseDetail1>
     <customUseDetail2 units="Square Feet" dataType="numeric" id="130086501" currentAsOf="2000-01-01" temporary="false" default="No">
          <customName>test detail 2</customName>
          <value>120</value>
     </customUseDetail2>
</useDetails>
ENVIRONNEMENT D'ESSAI