Jusqu’ici, de nombreuses intégrations PrestaShop (ERP, CRM, PIM, WMS, marketing automation) reposaient sur le Webservice historique. Il a rendu service pendant des années, mais il porte les limites d’une API “legacy” : modèle centré sur l’ObjectModel, mécanismes de sécurité plus simples (clé), et une standardisation moindre côté REST/JSON.
Avec PrestaShop 9, une nouvelle étape est franchie : l’Admin API est désormais l’API recommandée pour remplacer progressivement le Webservice. Basée sur API Platform v3, OAuth2 et une approche CQRS (Command/Query), elle vise une couche d’intégration moderne, standardisée et pérenne, avec une transition explicitement encouragée par l’écosystème et l’initiative “Call for Contributions” (2025).
1) Pourquoi quitter le Webservice legacy : enjeux techniques et business
Côté business, les motivations sont claires : simplifier les intégrations et l’automatisation, s’aligner sur des standards REST/JSON plus classiques, et préparer l’extensibilité à long terme. Le Help Center PrestaShop met en avant ces bénéfices (intégrations, automatisation, conformité aux standards, extensibilité), typiques des projets qui “dépassent” le simple export/import ponctuel.
Côté technique, le Webservice legacy est fortement lié à l’ObjectModel. Cette proximité avec la structure interne facilite certains usages, mais elle rend l’API moins “orientée domaine” et plus dépendante de choix d’implémentation historiques. Lorsque le métier évolue, l’API peut refléter des contraintes internes plutôt qu’un contrat d’intégration stable.
La stratégie annoncée autour de PrestaShop 9 consiste à organiser la “transition away from web services” vers une couche d’intégration solide et standardisée. En 2025, PrestaShop réaffirme cette trajectoire : l’Admin API est présentée comme une manière moderne et “future-proof” de remplacer progressivement les web services legacy, tout en étendant la couverture d’endpoints sur les entités majeures.
2) Admin API PrestaShop 9 : ce qui change réellement
La nouveauté n’est pas seulement un nouvel endpoint : c’est un socle technique différent. L’Admin API de PrestaShop 9 est basée sur API Platform v3 et utilise OAuth comme protocole d’autorisation. PrestaShop met aussi en avant l’usage de CQRS (commandes et requêtes), en contraste avec les web services “connectés à ObjectModel”.
Concrètement, on passe d’une API centrée sur des ressources proches du modèle interne à des endpoints davantage orientés “domaine” (domain-oriented). L’objectif est d’obtenir un contrat plus cohérent pour les intégrateurs : des opérations de lecture (Query) et d’écriture (Command) pensées pour les cas d’usage réels (gestion produit, stock, commandes…), plutôt que pour coller aux classes internes.
Autre différence structurante : dans PrestaShop 9, l’Admin API est “enabled by default”. Autrement dit, elle est disponible out-of-the-box lors de l’installation, ce qui impacte directement les stratégies de migration : vous pouvez commencer à basculer des flux sans dépendre d’une activation manuelle complexe (tout en respectant la configuration sécurité, notamment HTTPS en production).
3) Sécurité et authentification : de la clé Webservice à OAuth2 + scopes
Le Webservice historique s’appuie souvent sur une clé (API key) et des droits associés. L’Admin API change de paradigme : elle est basée sur OAuth2. Cela apporte une approche plus standard pour gérer l’authentification et l’autorisation, particulièrement utile quand plusieurs applications (ERP, connecteurs, scripts internes) doivent cohabiter.
La notion de scopes devient centrale. Au lieu d’un accès large accordé à une clé, on autorise précisément des capacités (par exemple lecture/écriture produits). La documentation montre des exemples de scopes comme product_read et product_write, et illustre les réponses d’erreur en cas de permissions insuffisantes, notamment le 403 avec le message “Invalid scope.”. Cette granularité est un levier puissant pour réduire les risques.
Enfin, PrestaShop 9 peut être “resource server” et interagir soit avec un serveur d’autorisation OAuth2 interne, soit avec un serveur externe. Cette flexibilité est importante en entreprise : elle permet d’aligner PrestaShop avec une stratégie IAM/SSO existante, ou de démarrer plus simplement avec le serveur d’autorisation fourni.
4) Premiers pas concrets : obtenir un token et appeler /admin-api
La page officielle “How to use the Admin API” sert de guide opérationnel : récupération de token, lecture/écriture (CRUD), ajout/suppression, import de collection, et accès à la documentation Swagger. Pour une équipe habituée au Webservice, c’est la checklist de migration : reproduire un flux existant (ex. mise à jour produit) en suivant ces étapes.
L’appel se fait avec un Bearer token sur des endpoints préfixés /admin-api/.... La documentation donne des exemples curl avec un er du type Authorization: Bearer YOUR_ACCESS_TOKEN, et un endpoint de test comme /admin-api/api-client/infos. C’est une étape clé pour valider rapidement que l’authentification, la base URL et le routage sont corrects.
Ce même endpoint /admin-api/api-client/infos permet aussi de vérifier les scopes accordés au client OAuth. En migration, c’est une excellente pratique : vous comparez les droits requis par vos scripts Webservice (lecture/écriture) et vous les traduisez en scopes, puis vous testez immédiatement les cas d’échec attendus (ex. une écriture sans scope product_write).
5) Explorer et tester : Swagger, outillage, et boucle de développement
L’Admin API fournit une documentation générée accessible via /admin-api/docs.. Pour une migration, cela change le quotidien : au lieu de naviguer entre pages et exemples disparates, vous avez un point d’entrée interactif pour inspecter les routes, les payloads, et accélérer le prototypage.
La documentation officielle structure aussi des scénarios essentiels : lecture et écriture, ajout/suppression, import de collection. Cette notion d’import de collection est particulièrement intéressante pour remplacer certains usages “batch” que l’on implémentait parfois autour du Webservice, en essayant de limiter le nombre d’appels et de gérer les erreurs de manière robuste.
En pratique, une bonne boucle de migration consiste à : (1) identifier un flux Webservice (ex. synchro catalogue), (2) retrouver l’équivalent Admin API dans Swagger, (3) tester via curl ou Postman avec Bearer token, (4) implémenter côté application, (5) valider les scopes minimaux, puis (6) industrialiser (retries, logs, monitoring, rotation de tokens/clients).
6) Architecture et contrat : CQRS, endpoints orientés domaine, et module ps_apiresources
L’Admin API s’appuie sur CQRS : d’un côté des queries (lecture), de l’autre des commands (écriture). PrestaShop souligne que ces endpoints sont plus “domain-oriented” que des web services traditionnels reliés à l’ObjectModel. Pour l’intégrateur, cela signifie souvent des payloads et des opérations plus alignés sur les besoins métier (et potentiellement moins dépendants de détails internes).
Un point concret à connaître : les endpoints Admin API sont fournis via le module ps_apiresources. Les contributions d’extension d’endpoints (dans le cadre de l’initiative 2025) doivent être intégrées dans ce module, ce qui formalise un “contrat” d’API livré et versionné via un composant dédié.
Techniquement, le dépôt ps_apiresources rappelle que tous les endpoints sont basés sur des commands/queries CQRS et qu’API Platform sert de base. Pour une migration depuis le Webservice, c’est une information structurante : l’API n’est pas un simple “nouveau format”, c’est une nouvelle manière de concevoir les opérations (et donc parfois de repenser la façon dont votre application écrit/valide les données).
7) Migration progressive : couverture fonctionnelle, risques de version, et stratégie 2025
La migration ne se fait pas toujours en “big bang”, notamment parce que la couverture fonctionnelle des endpoints peut évoluer. La feuille de route 2025 mentionne l’objectif d’étendre l’Admin API avec davantage d’endpoints couvrant toutes les entités majeures de PrestaShop. Cela implique souvent une approche hybride temporaire : Admin API là où c’est disponible, Webservice (ou autres mécanismes) le temps de combler certains manques.
Un point de vigilance : le module ps_apiresources est encore en version 0., avec la mention explicite que des breaking changes sont possibles avant 1.0. Cela ne remet pas en cause la direction “recommandée”, mais impose une discipline de versioning côté intégration : pin de versions, tests de non-régression, et surveillance des releases.
À ce titre, l’existence d’une release v0.2.0 datée du 30 novembre 2025 signale une activité récente et des évolutions continues. En migration, planifiez un “budget” de maintenance : suivre les changements, adapter les clients, et idéalement contribuer (ou au moins remonter des besoins) dans la dynamique “Call for Contributions” qui vise précisément à accélérer la transition de l’écosystème.
8) Bonnes pratiques opérationnelles : HTTPS, environnements, et gouvernance des accès
Sur la sécurité transport, PrestaShop rappelle un point important : en production, l’API doit être strictement sécurisée et nécessite HTTPS (TLS). Il est possible de désactiver un contrôle TLSv1.2 uniquement en mode debug, ce qui doit rester une exception pour du développement local ou des environnements de test maîtrisés.
Sur la gouvernance OAuth2, adoptez des clients distincts par application (ERP, middleware, script interne), avec des scopes minimaux. Ce découpage facilite l’audit, la révocation ciblée, et la réduction d’impact en cas de fuite de credentials. Pensez aussi à journaliser les appels (correlation-id), et à surveiller les taux de 401/403 pour détecter rapidement une régression de scopes.
Enfin, documentez votre matrice “flux → endpoints → scopes”. La communauté partage déjà des guides quickstart sur les scopes (ex. product_read, product_write) utiles pour comprendre les droits nécessaires lors d’une migration. Cette formalisation évite que la migration se résume à “ça marche sur mon poste”, et prépare un passage en exploitation plus sûr.
Passer du Webservice à l’Admin API sur PrestaShop 9 n’est pas qu’une mise à jour technique : c’est un changement de contrat et de posture. En adoptant API Platform v3, OAuth2, les scopes et CQRS, PrestaShop propose une couche d’intégration plus standard, mieux sécurisée, et pensée pour durer, avec une volonté officielle d’organiser la transition away from web services.
La meilleure approche est progressive et outillée : commencer par authentifier un client OAuth, valider les scopes via /admin-api/api-client/infos, explorer /admin-api/docs., migrer flux par flux, et gérer le risque de breaking changes tant que ps_apiresources reste en 0.. En suivant cette trajectoire, vous préparez des intégrations plus robustes et plus “future-proof”, alignées avec la direction produit de PrestaShop.

