Cancel Order
Logo Slider
Cart Reservation
Magic Menu
PageSpeed
DeleteX
ChargeMe
Age Restriction 18+
DocumenThemix
Agile Search
Newsletter Popup
IConvert Promotion
Trusty Sale Proof
Countdown x Bar
Xleft
Jump to Checkout
PrestaSEO AI++
Accessibility Guard
SOO Agent Gateway
SOO Agent Catalog Tools
SOO Agent SEO Tools
GDPR
Create a new accountAPI Admin PrestaShop 9 : Commerce Headless et Guide d'Integration
PrestaShop 9 introduit une toute nouvelle API Admin basee sur API Platform avec authentification OAuth 2.0. Cela ouvre la voie au commerce headless, aux fronts-end personnalises et aux integrations tierces avancees.
Qu'est-ce que l'API PrestaShop 9 Admin?
La nouvelle API Admin est une API REST construite sur API Platform, un cadre PHP pour la construction d'API modernes. Il utilise l'authentification OAuth 2,0, remplaçant l'ancien système de clé API de l'API Webservice.
Principales différences par rapport à l'API du service Web hérité
| Fonctionnalité | Legacy Webservice (PS8) | API Admin (PS9) |
|---|---|---|
| Authentification | Clé API (de base) | OAuth 2.0 (identificateurs de client) |
| Cadre | XML/JSON personnalisé | API Platform (standard) |
| Sécurité | limitée | Flux modernes OAuth |
| Support sans tête | Partielle | Complète |
Que pouvez - vous construire?
- Frontières sans tête — façades personnalisées React, Vue ou Next.js
- Applications mobiles — applications iOS/Android natives connectées à votre magasin PrestaShop
- Intégrations ERP/CRM — commandes de synchronisation, produits et clients avec des systèmes externes
- Tableaux de bord personnalisés — build analytics and reporting outils on top of your store data
Comment activer l'API Admin
- Aller à Back Office → Paramètres avancés → Accès aux API
- Créer un nouveau client API avec les champs requis
- Notez votre identifiant client et secret
- Utilisez OAuth 2.0 flux de références client pour obtenir un jeton d'accès
- Inclure le jeton dans les requêtes d'API comme jeton porteur
Le service Web Legacy est-il toujours disponible?
Oui. L'ancienne API Webservice fonctionne toujours dans PrestaShop 9 pour la compatibilité arrière. Cependant, l'API Admin est l'approche recommandée pour toutes les nouvelles intégrations.
Ressources connexes
Voir le PrestaShop 9 guide complet pour plus de détails techniques.
Obtenir un jeton d'accès — Exemple de boucle
La première étape est de créer un client API dans votre back office (Paramètres avancés → Accès aux API), puis de demander un jeton:
curl -X POST "https://yourstore.com/oauth2/token"
-H "Content-Type: application/x-www-form-urlencoded"
-d "grant_type=client_credentials"
-d "client_id=your_client_id"
-d "client_secret=your_client_secret"
# Response:
{
"access_token": "eyJ0eXAiOiJKV1Q...",
"token_type": "Bearer",
"expires_in": 3600
}Votre premier appel API
Une fois que vous avez le jeton, incluez-le comme jeton porteur dans vos demandes d'API:
# List products
curl -X GET "https://yourstore.com/api/products"
-H "Authorization: Bearer eyJ0eXAiOiJKV1Q..."
# Get a single order
curl -X GET "https://yourstore.com/api/orders/12345"
-H "Authorization: Bearer eyJ0eXAiOiJKV1Q..."Portées et ressources de l'API disponibles
| Ressources | Portée | Méthodes |
|---|---|---|
| Produits | Produit read / Produit write | Allez, Post, Put, Delete |
| Ordonnances | Lisez / Order write | Allez-y. |
| Clients | customer read / customer write | Allez, Post, Put, Delete |
| Catégories | category read / category write | Allez, Post, Put, Delete |
| Règles du panier | cart rule read / cart rule write | Allez, Post, Put, Delete |
| Transporteurs | Lisez le support | Allez |
| Monnaies | Lisez la monnaie | Allez |
Cas d'utilisation dans le monde réel
1. Avant du magasin sans tête
Construisez un front-end React ou Next.js personnalisé qui récupère les produits, les catégories et les poignées de panier/de contrôle via l'API Admin. PrestaShop gère la logique commerciale; votre front-end personnalisé gère l'UX.
2. Application mobile
Connectez une application iOS ou Android native à votre magasin PrestaShop. L'application s'authentifie avec OAuth, puis lit les produits, passe les commandes et vérifie l'état de la commande via API — pas de grattage web nécessaire.
3. Intégration ERP/CRM
Synchronisez les commandes de PrestaShop à votre ERP (par exemple SAP, Odoo) automatiquement. Utilisez un travail de cron pour effectuer de nouvelles commandes via l'API Commandes et les pousser à votre ERP. Mettre à jour les niveaux de stock dans PS depuis ERP via l'API Produits.
4. Tableau de bord de l'analyse personnalisée
Tirez les données de commande, client et produit dans un outil BI personnalisé (Power BI, Metabase, Grafana) pour une analyse plus approfondie que les statistiques PrestaShop intégrées.
Migration de l'API de Webservice Legacy vers l'API Admin
| Aspect | Service Web hérité | API Admin (PS9) |
|---|---|---|
| Authentification | Clé API dans l'en-tête | OAuth 2.0 Jeton porteur |
| Expiration du jeton | Jamais (clé statique) | 3600s (refroidissement nécessaire) |
| URL de base | /api/products?output format=JSON | /api/produits |
| Format de réponse | XML ou JSON | JSON (JSON-LD) |
| Filtrage | Params de requête | Filtres |
L'ancienne API Webservice reste fonctionnelle en PS9 pour la compatibilité arrière. Vous n'avez pas besoin de migrer les intégrations existantes immédiatement, mais les nouvelles intégrations devraient utiliser l'API Admin.
Foire aux questions
L'API Admin est-elle disponible en PrestaShop 8?
C'est pas vrai. La nouvelle API Admin basée sur OAuth est exclusive à PrestaShop 9. PrestaShop 8 utilise l'ancienne API Webservice avec authentification des clés API.
Ai-je besoin de connaissances en codage pour utiliser l'API?
Une connaissance fondamentale de l'API REST est requise. Vous devez comprendre les requêtes HTTP (GET, POST, PUT, DELETE), le format de données JSON et les flux de jeton OAuth 2.0. Des bibliothèques sont disponibles pour PHP, Python, JavaScript pour simplifier cela.
