Documentation de service Web / Catégories / Services d'utilisation de la propriété / Obtenir ce qui a changé Liste d'utilisation des biens (à partir des changements de détail d'utilisation seulement)

Obtenir ce qui a changé Liste d'utilisation des biens (à partir des changements de détail d'utilisation seulement)

Mise à jour le 26 février 2024

Description

Ce service Web permet de renvoyer une liste d’utilisations de propriété qui ont changé depuis une date spécifiée par un utilisateur. Les utilisations de propriété de la liste renvoyée sont spécifiques aux identifiants de compte. Les résultats sont envoyés par paliers de 1000 par série. La liste renvoyée montre uniquement les utilisations de propriété que vous êtes autorisés à voir. Les actions qui entraînent l’inclusion d’une utilisation de propriété dans la liste renvoyée ont pu être effectuées par n’importe quel utilisateur ayant accès à l’utilisation de propriété. L’utilisation de propriété est affichée si les détails d’utilisation correspondants sont corrigés ou mis à jour avec un nouveau document historique.

Version

22.0

Méthode HTTP

GET

URL de la ressource

/customer/(customerId)/useDetails/whatChanged?date=(YYYY-MM-DD)

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
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.

Schémas XML

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

Exemple de demande

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 dont l’identifiant est 100.

GET  /customer/100/useDetails/whatChanged?nextPageKey=3000&date=2010-07-31

Exemple de réponses

L’exemple suivant permet de renvoyer une liste d’utilisations de propriété pour les clients dont l’identifiant est 100 qui ont changé depuis le 31 juillet 2010. La liste contient des liens vers des services Web que vous pouvez appeler pour obtenir des renseignements sur chaque utilisation de propriété. Remarque : les identifiants des détails d’utilisation spécifiques ne sont pas renvoyés.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
     <links>
          <link id="861" httpMethod="GET" link="/propertyUse/861" linkDescription="This is the GET url for this property use." hint="office"/>
          <link id="341" httpMethod="GET" link="/propertyUse/341" linkDescription="This is the GET url for this property use." hint="Warehouse"/>
          <link httpMethod="GET" link="/customer/100/propertyUse/whatChanged?nextPageKey=4000&date=2010-07-31" linkDescription="next page"/>
          <link httpMethod="GET" link="/customer/100/propertyUse/whatChanged?previousPageKey=3000&date=2010-07-31" linkDescription="previous page"/>
     </links>
</response>

Une liste sans utilisation de propriété est affichée. Aucune utilisation de propriété a été modifiée.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
     <links/>
</response>
ENVIRONNEMENT D'ESSAI