Site icon Votre graphiste en ligne

PrestaShop 9 : l’Admin API change la donne

La sortie de PrestaShop 9, officiellement publiée le 10 juin 2025, marque un nouveau chapitre pour la plateforme e‑commerce open source. Au cœur de cette version se trouve une refonte importante de l’API d’administration : une Admin API moderne, activée par défaut et pensée pour les intégrations et l’automatisation.

PrestaShop SA a fortement porté cette version , environ 80 % des pull requests pour PrestaShop 9 proviennent de l’équipe core , tout en lançant un appel aux contributions pour compléter l’Admin API. Les fondations sont posées; la suite dépendra d’une collaboration active entre l’équipe et la communauté.

Quoi de neuf dans PrestaShop 9

PrestaShop 9 apporte plusieurs changements techniques et organisationnels destinés à rendre la plateforme plus robuste et plus facile à intégrer. La version 9.0 a été rendue publique le 10 juin 2025 et introduit des bases techniques modernisées ainsi qu’une Admin API repensée.

Parmi les nouveautés listées officiellement figurent des intégrations facilitées, l’automatisation des tâches back‑office, un design REST/JSON standardisé et une extensibilité pensée dès l’origine. PrestaShop précise toutefois que l’API reste « work in progress » : les fondations sont là, mais certains endpoints restent à compléter.

La communauté est invitée à planifier la montée de version via l’Update Assistant (Update Assistant 7) et à tester modules, thèmes et intégrations en staging avant tout passage en production , une recommandation particulièrement importante pour les intégrateurs qui migrent depuis l’ancien Webservice XML.

Une nouvelle base technique : Symfony 6.4 et PHP 8.x

La plateforme repose désormais sur Symfony 6.4 (LTS), avec un support de sécurité garanti jusqu’en novembre 2027. Ce choix assure une base stable et maintenue pour la durée de vie de PrestaShop 9.

PrestaShop 9 prend en charge PHP 8.1 à 8.4, ce qui permet d’exploiter des améliorations de performance et de sécurité offertes par les versions récentes de PHP. Les développeurs devront s’assurer que leurs environnements d’hébergement et leurs modules sont compatibles avec ces versions.

La combinaison Symfony 6.4 + PHP 8.x prépare ainsi le terrain pour des pratiques de développement modernes : meilleure maintenabilité, sécurité et capacité à intégrer des composants comme API Platform pour l’Admin API.

L’Admin API : architecture et principes

La grande nouveauté est l’Admin API, entièrement reconstruite sur API Platform et activée par défaut dans PrestaShop 9. Cet ensemble est conçu pour faciliter les intégrations CRM/ERP, l’automatisation et une conformité aux bonnes pratiques REST/JSON.

Côté sécurité et authentification, l’Admin API s’appuie sur OAuth2. Plusieurs endpoints adoptent le pattern CQRS (séparation Commands/Queries) afin de distinguer clairement lecture et écriture et de raisonner métier de façon plus modulaire.

PrestaShop décrit l’initiative ainsi : "The new Admin API introduced in PrestaShop 9 lays a solid foundation." Cette phrase résume l’intention : poser des bases saines pour évoluer vers une couverture API complète, étape par étape.

Documentation, découverte et outillage

L’API génère automatiquement une documentation OpenAPI (ex. /admin-api/docs.json) que l’on peut importer dans des clients HTTP comme Postman ou Insomnia. Les guides « How to use the Admin API » et la documentation développeur accompagnent la découverte et l’utilisation.

Des tutoriels montrent des exemples concrets : importer la collection OpenAPI dans Postman, exécuter des requêtes curl pour GET/POST/DELETE, et suivre des workflows d’authentification OAuth2. Ces ressources facilitent la prise en main pour développeurs et intégrateurs.

La documentation DevDocs détaille aussi les bonnes pratiques : les opérations READ via Queries CQRS, les WRITE via Commands, et les listes via une Grid data factory; des exemples de structure de projet sont fournis (ps_apiresources/src/ApiPlatform/Resources).

Extensibilité et contribution : ps_apiresources et appel à la communauté

PrestaShop propose un modèle d’extension via le module ps_apiresources, recommandé pour ajouter de nouveaux endpoints et resources API, avec des tests d’intégration associés. Ce modèle standardise les contributions et facilite l’intégration dans le core.

Un programme communautaire , Call for Contributions Admin API , a été lancé pour combler les endpoints manquants. Un canal Slack dédié (#cfc-adminapi), un étiquetage des PRs (« Admin API Contribution ») et un coverage tracker permettent de coordonner les efforts et de suivre la progression.

La revue des contributions a commencé en septembre 2025 et l’objectif est d’achever l’initiative Admin API d’ici fin 2025. Cette timeline publique montre que la collaboration est essentielle pour atteindre une couverture API complète dans les versions 9.0 / 9.1.

Bonnes pratiques techniques pour les contributeurs

Les DevDocs fournissent des recommandations précises : utiliser des Queries pour les opérations READ, des Commands pour les WRITE, et gérer les LIST via la Grid data factory. Ces patterns aident à garder l’API cohérente et testable.

La structure de projet recommandée (ps_apiresources/src/ApiPlatform/Resources) sert de modèle pour les nouvelles resources, avec des exemples de tests d’intégration. Respecter ces conventions augmente les chances d’acceptation des PRs dans le core.

Le coverage tracker permet de visualiser les endpoints couverts et ceux qui manquent encore. Contribuer de manière ciblée (suivre les labels et le canal #cfc-adminapi) maximisera l’impact de chaque développeur ou intégrateur.

Impact pour les intégrateurs et recommandations pratiques

Pour les intégrateurs, la nouvelle Admin API représente une invitation à migrer depuis l’ancien Webservice XML vers un modèle moderne (API Platform + OAuth2 + CQRS). Cette migration offre de meilleurs standards REST/JSON et facilite l’automatisation et les intégrations tierces.

Toutefois, la couverture d’endpoints n’est pas encore complète : il est recommandé de procéder à des audits, de tester en staging et d’utiliser l’Update Assistant 7 pour planifier la montée de version. Les modules et thèmes doivent être validés avant le passage en production.

En pratique, commencez par importer /admin-api/docs.json dans Postman pour explorer les endpoints disponibles, testez des flux courants (authentification OAuth2, lecture de produits, création de commandes) et participez au Call for Contributions pour combler les manques si nécessaire.

PrestaShop 9 pose des bases solides pour l’avenir du back‑office et des intégrations. L’Admin API, construite sur API Platform, OAuth2 et des patterns CQRS, est un tournant technique qui facilite les automatismes et les connexions avec des outils externes.

La suite dépendra d’une dynamique communautaire active : PrestaShop SA a mené la majorité du travail initial (≈ 80 % des PRs), mais l’appel aux contributions et la timeline publique montrent qu’une collaboration soutenue permettra d’atteindre une couverture API complète d’ici la fin 2025. Pour les développeurs et intégrateurs, c’est le moment idéal pour se familiariser, tester et contribuer.

Quitter la version mobile