L'état de votre veille
Cet appel répond à la question que se pose une intégration en boucle : est-ce que ma veille tourne vraiment ? Pour chaque produit suivi, il indique les marketplaces appariées, la dernière lecture réussie et ce qui a échoué.
C'est le bon appel à programmer une fois par jour pour détecter un produit qui a cessé d'être trouvé sur une marketplace.
curl -H "Authorization: Bearer swp_votre_cle" \
https://api.sweeprice.com/v1/productsLe marché d'un produit
Les offres concurrentes relevées, le meilleur prix, qui tient l'offre à la une, et l'évolution sur la fenêtre demandée.
La fenêtre se règle avec days. Elle reste bornée par la profondeur d'historique de votre formule : demander trois cents jours sur une formule qui en conserve trente renvoie trente jours, sans erreur.
curl -H "Authorization: Bearer swp_votre_cle" \
"https://api.sweeprice.com/v1/products/PRODUCT_ID/market?days=30"Le prix comparable
Un vendeur peut déplacer sa marge entre le prix affiché et les frais de port. Comparer sur le seul prix article récompenserait ce déplacement, donc les offres portent les deux séparément et c'est leur somme qui fait foi.