Données historiques

Last modified: 1. octobre 2021

Exigences

Pour obtenir des données historiques, un contrat de données historiques correspondant est nécessaire. Un aperçu de tous les contrats est disponible sur ITscope.com.

Les données historiques ne sont disponibles qu’à partir de l’API 2.1 (version actuelle de l’API) et uniquement pour les demandes API de produits (products/ean, products/id, products/search). Aucune donnée historique n’est mise à disposition via l’exportation de données.

Paramètres de la requête

Afin de recevoir des données historiques via API, certains paramètres doivent être spécifiés, qui peuvent également être vus dans l’API interactive 2.1 :

  • historyFrom: L’heure de début des données historiques au format aaaa-MM-jj. Ce n’est que si ce paramètre est défini et que les conditions préalables ci-dessus sont remplies que des données historiques sont ajoutées à la réponse. Le début du mois ou le début de la semaine ne doit pas toujours être transféré, car la méthode d’agrégation correspondante détermine toujours automatiquement le premier jour du mois ou le premier jour de la semaine
  • historyTo: L’heure de fin pour les données historiques au format aaaa-MM-jj. Si aucune valeur n’est transmise, la valeur par défaut est la date du jour
  • historyAggregation: La granularité des données historiques. Valeurs possibles weekly pour l’agrégation hebdomadaire et monthly pour l’agrégation mensuelle. Le paramètre doit être défini, car il n’y a pas de valeur par défaut.

Les délais de réponse dépendent également beaucoup de ces paramètres de demande, puisque selon les périodes et l’agrégation demandées, les données historiques correspondantes doivent être rechargées ou agrégées.

Formats de données

Les données historiques sont disponibles dans le format de données API 2.1 standard et developer. Les différents champs et types de données sont également décrits dans les formats de données respectifs.

Exemples

Développement du prix hebdomadaire d’un exemple de produit :

https://api.itscope.com/2.1/products/id/5050452000/standard.json?historyFrom=2017-11-22&historyTo=2018-02-01&historyAggregation=weekly

Recherchez « iPhone 8 Plus » pour récupérer les prix historiques pour une date spécifique à filtrer et à calculer :

https://api.itscope.com/2.1/products/search/manufacturer=88;producttype=130;keywords=%22iphone%208%20plus%22/standard.json?historyFrom=2017-11-15&historyTo=2018-01-22&historyAggregation=monthly

Was this article helpful?
Dislike 0
Views: 40