API de données de prix — accédez aux données de surveillance depuis vos propres systèmes
L'API REST de 4pricing.net permet à votre équipe technique de récupérer les données de surveillance des prix dans vos propres systèmes (par exemple un ERP, un WMS ou une boutique en ligne). 4pricing ne propose pas de connecteurs prêts à l'emploi : la liaison est construite par votre développeur sur l'API. L'authentification repose sur une clé API, les réponses sont au format JSON standard et la spécification est publiée en OpenAPI 3.0, importable telle quelle dans votre client.
Principaux endpoints
L'API expose les données de surveillance au niveau du produit suivi : la liste des produits avec leur prix actuel, l'historique de prix d'un produit et un mini-historique en lot pour les vues en liste. Les produits sont identifiés par le product_id renvoyé lors de leur ajout — c'est lui qui sert de clé de routage. Les montants sont exprimés en unités mineures, dans les champs current_price_cents et price_cents, accompagnés de la devise, et chaque enregistrement porte l'heure exacte de la vérification (respectivement last_scraped_at et scraped_at).
- GET /products/ — vos produits suivis, avec prix actuel et devise
- GET /products/{product_id}/history — l'historique de prix d'un produit, avec horodatages
- GET /products/sparklines — mini-historique en lot, une série de prix par produit
- POST /alerts/ — créer une alerte (seuil, baisse en pourcentage, stock, concurrent)
Authentification et limitation de débit
L'authentification s'effectue via l'en-tête X-API-Key ou, de façon équivalente, Authorization: Bearer avec la même clé. Les clés se génèrent depuis le panneau, dans la section API et clés, et la valeur complète n'est affichée qu'une seule fois, à la création. La limite est de 60 requêtes par minute et par compte, partagée entre toutes vos clés ; au-delà, l'API répond 429 et renvoie l'en-tête Retry-After.
Avantages et limites
Avantages
- Votre équipe peut alimenter son propre ERP/WMS directement depuis l'API, sans export CSV manuel (le connecteur, c'est vous qui le construisez)
- Les alertes peuvent être transmises par webhook : aucun polling imposé
- Une spécification OpenAPI 3.0 publiée, importable directement dans votre client
- Accès au prix recommandé pour le groupe de comparaison, pas uniquement aux données brutes
Limites
- La limite de 60 requêtes/minute par compte (partagée entre toutes les clés) impose des lectures en lot et une mise en cache locale sur les gros catalogues
- Le webhook exige une URL http/https publique (port 80/443) sur votre infrastructure
Verdict rapide
L'API couvre la lecture des données de surveillance et du prix recommandé, l'envoi de vos propres prix et l'application du prix recommandé, mais elle n'est pas livrée avec des connecteurs pour ERP ou boutique. Les grands catalogues gagnent à recourir aux lectures en lot (pagination, mini-historique en lot) et à un cache local.
Tableau des spécifications
| Endpoint | Méthode | Réponse |
|---|---|---|
| /products/ | GET | Tableau JSON des produits suivis, avec current_price_cents |
| /products/{product_id}/history | GET | Tableau JSON de l'historique, avec horodatages |
| /products/sparklines | GET | JSON avec une série de prix par produit |
| /alerts/ | POST | L'alerte créée, avec son type et son seuil |
API vs. export CSV à la demande
| Critère | API REST | Export CSV |
|---|---|---|
| Latence des données | Les données datent de la dernière vérification | Données arrêtées au moment du téléchargement |
| Liaison avec l'ERP | Via HTTP, avec un connecteur écrit par votre équipe | Import manuel ou par cron |
| Alertes push | Oui (webhook) | Non |
Questions fréquentes
Comment obtenir une clé API ?
Vous générez la clé depuis le panneau de votre compte 4pricing.net, dans la section API et clés. La valeur complète de la clé n'est affichée qu'une seule fois, à la création — si vous la perdez, révoquez-la et générez-en une autre.
Puis-je accéder aux données de tous les produits en même temps ?
Oui : GET /products/?skip=0&limit=200 permet de parcourir tout le catalogue suivi page par page ; le nombre total de lignes est renvoyé dans l'en-tête X-Total-Count. Pour les longues listes, GET /products/sparklines renvoie le mini-historique de plusieurs produits en un seul appel. Nous recommandons une synchronisation nocturne pour les gros catalogues et des lectures plus fréquentes uniquement pour les produits qui comptent.
Quel est le format de l'historique de prix renvoyé par l'API ?
Un tableau JSON d'objets {product_id, price_cents, currency, in_stock, scraped_at}, triés par date décroissante. Le prix est exprimé en unités mineures (price_cents), et non en unités monétaires entières, et scraped_at est un horodatage ISO 8601 exact.
Quels événements le webhook envoie-t-il ?
Il y a une seule URL de webhook par compte, et elle reçoit chaque type d'alerte que vous créez : prix inférieur à un seuil, prix supérieur à un seuil, baisse en pourcentage, retour en stock, concurrent qui passe sous votre prix et perte de la position de prix le plus bas. Il n'existe pas d'alerte sur le plancher de coût en tant que tel.