announcement

During the current lapse in appropriations, EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. Many services may not be available during this time.

Documentation de service Web / Catégories / Services de compte de base / Récupérer le client

Récupérer le client

Mise à jour le 22 février 2021

Description

Ce service Web récupère l'information de compte d'un client spécifique avec qui vous êtes connecté.

Version

25.0

Méthode HTTP

GET

URL de la ressource

/customer/(customerId)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
customerId Identifiant du client

Schémas XML

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

Exemple de demande

L'exemple suivant montre la récupération de l'information de compte pour le client dont l'identifiant correspond à 23421.

GET  /customer/23421

Exemple de réponses

L'exemple suivant affiche l'information de compte pour le client dont l'identifiant correspond à 23421.

<?xml version="1.0" encoding="UTF-8"?>
<customer>
     <username>acme_customer</username>
     <billboardMetric>score</billboardMetric>
     <includeTestPropertiesInGraphics>true</includeTestPropertiesInGraphics>
     <accountInfo>
          <firstName>John</firstName>
          <lastName>Doe</lastName>
          <address address1="123 Main St" city="Arlington" state="VA" postalCode="22201" country="US"/>
          <email>john_doe@acme.com</email>
          <organization>ACME Corporation</organization>
          <jobTitle>Building Administrator Data Exchange User</jobTitle>
     </accountInfo>
</customer>

Dans l’exemple suivant, les informations sont affichées pour le compte du client portant le numéro d’identification 23421.Si le compte appartient à une entité canadienne, un paramètre de préférences courriel (PreferenceCourrielCompteCanadien) est inclus afin d’indiquer si le compte peut recevoir des informations ENERGY STAR de la part de Ressources naturelles Canada (RNCan). 

<?xml version="1.0" encoding="UTF-8"?>
<customer>
     <username>acme_customer</username>
     <billboardMetric>score</billboardMetric>
     <includeTestPropertiesInGraphics>true</includeTestPropertiesInGraphics>
     <accountInfo>
          <firstName>John</firstName>
          <lastName>Doe</lastName>
          <address address1="123 Main St" city="Edmonton" state="AB" postalCode="T5G 2S7" country="CA"/>
          <email>john_doe@acme.com</email>
          <organization>ACME Corporation</organization>
          <jobTitle>Building Administrator Data Exchange User</jobTitle>
     </accountInfo>
     <emailPreferenceCanadianAccount>true</emailPreferenceCanadianAccount>
</customer>
ENVIRONNEMENT D'ESSAI