Synchroniser votre catalogue.

Ce guide décrit le chargement initial du catalogue et sa mise à jour incrémentale.

Synchronisation initiale

Charger les boutiques
GET /v1/shops fournit les identifiants publics utilisés par la disponibilité.
Charger les référentiels
Récupérez catégories, types de produits et caractéristiques avant les produits.
Parcourir le catalogue agrégé
Utilisez GET /v1/catalog/products page par page et enregistrez produits, articles, prix et stock.
Mémoriser le point de reprise
Conservez l’horodatage de fin pour alimenter vos synchronisations suivantes.

Lecture paginée

Produits disponiblesbash

curl "https://api.hbjo-online.com/v1/catalog/products?page=1&limit=100&availableOnly=true" \
  -H "Authorization: Bearer $TOKEN"

Synchronisation incrémentale

Appelez GET /v1/catalog/changes avec since. Conservez la valeur until de la première réponse, transmettez-la sur les pages suivantes, puis utilisez-la comme prochain point de reprise.

Changements depuis le dernier passagebash

curl "https://api.hbjo-online.com/v1/catalog/changes?since=2026-08-31T08:00:00Z&page=1&limit=100" \
  -H "Authorization: Bearer $TOKEN"

Utilisez le prix et la disponibilité retournés par l’API comme valeurs faisant foi. Ne déduisez pas le stock depuis le nombre d’articles reçus.

Scopes nécessaires

products:read, stock:read et referentials:read.

Guide suivantGérer les clients →RéférenceVoir les routes Catalogue →