Avec PrestaShop 9, l’Admin API devient une nouveauté structurante : PrestaShop la présente officiellement comme une « toute nouvelle API Admin basée sur API Platform ». Ce positionnement change la manière de concevoir, documenter et surtout tester les échanges entre le Back-Office et les intégrations (ERP, PIM, connecteurs, scripts d’admin).
Dans cet article, on se concentre sur les tests d’intégration de cette Admin API « API Platform-based » : comment s’appuyer sur les pratiques Symfony/API Platform, comment exploiter l’architecture CQRS + OAuth décrite par PrestaShop, et comment utiliser le module ps_apiresources comme véhicule des endpoints et des suites de tests associées.
1) Ce que change l’Admin API PrestaShop 9 (API Platform, OAuth, CQRS)
PrestaShop 9 introduit une Admin API basée sur API Platform, annoncée comme une évolution majeure du produit. Concrètement, cela signifie que les endpoints suivent une approche standardisée (ressources, providers/processors, documentation automatique), et qu’on retrouve un écosystème de test mature côté Symfony.
Sur le plan architectural, l’article « Meet the new API Platform-based API » met en avant l’usage d’OAuth et une organisation des endpoints autour de CQRS (Command Query Responsibility Segregation). Cette séparation entre lecture (queries) et écriture (commands) influence directement la stratégie de tests : on ne valide pas seulement « une URL », mais aussi le câblage vers la bonne query/command, les handlers, et les effets attendus en base.
Il faut aussi intégrer les exigences techniques mentionnées : PHP 8.1 est requis, et la sécurité (HTTPS) est un sujet explicite. L’article indique notamment des paramètres comme « Force security in debug mode » en environnement de test/debug, et rappelle qu’en production l’HTTPS est attendu ; vos tests d’intégration doivent donc anticiper les contraintes de schéma (http/https) et d’authentification.
2) Pourquoi API Platform facilite (vraiment) les tests d’intégration
API Platform fournit un cadre cohérent pour tester une API Symfony : tests unitaires, tests fonctionnels, chargement de fixtures, et outils dédiés. La documentation officielle « Testing the API with Symfony » recommande une approche basée sur PHPUnit, des tests fonctionnels qui exercent l’API comme un client, et une gestion maîtrisée des données (fixtures/état initial).
Dans PrestaShop 9, l’intégration « API Platform and CQRS integration » documente des raisons concrètes au choix d’API Platform : abstractions Provider/Processor, génération automatique de la documentation (Swagger/OpenAPI), etc. Ces abstractions aident aussi à isoler les comportements dans les tests : un test d’intégration peut valider que la ressource est exposée, que le Provider renvoie la représentation attendue, et que les Processors déclenchent bien les commands.
Point important côté stabilité : la doc dev PrestaShop précise que les commands/queries CQRS sont Behat tested, ce qui est présenté comme « a good insurance for stability ». En pratique, cela signifie que vos tests d’intégration Admin API s’empilent sur une base déjà testée au niveau métier : vous cherchez alors surtout les régressions de couche HTTP, de sérialisation, de sécurité, et de wiring API Platform/CQRS.
3) Le rôle central de ps_apiresources pour les endpoints et leurs tests
PrestaShop pousse l’extension de la couverture d’endpoints via des contributions communautaires, avec une consigne claire : les nouveaux endpoints Admin API doivent être intégrés dans le module ps_apiresources. Le « call for contributions » (2025) formalise ce choix de livraison, et une mise à jour fin 2025 indique que la revue des contributions est active et que les endpoints validés sont intégrés dans ps_apiresources.
Le dépôt GitHub officiel PrestaShop/ps_apiresources fait office de source de vérité pour les ressources exposées : le README y précise que « all endpoints are based on CQRS… APIPlatform framework », et que le module contient des fichiers de ressources scannés par le Core. Pour les tests d’intégration, cela a deux conséquences : (1) vous testez un module, pas uniquement le Core, (2) vous devez reproduire une boutique « réaliste » (DB, config, modules) pour que le scan et l’enregistrement des ressources fonctionnent comme en conditions réelles.
La doc dev « Create new API endpoints using CQRS » illustre aussi l’organisation attendue (arborescence, conventions) et cite un exemple explicite de test d’intégration API Platform (par ex. tests/Integration/ApiPlatform/.../AttributeGroupEndpointTest.php). Autrement dit, le projet assume que les endpoints doivent venir avec leurs tests d’intégration dédiés, au même endroit que le code des ressources.
4) Mettre en place des tests d’intégration localement (workflow recommandé)
Le README de ps_apiresources documente une procédure « Run tests locally » orientée intégration : préparer une boutique temporaire, mettre en place la base de données et l’installation, puis lancer les tests via une commande du type composer run-module-tests. L’idée est de lancer les tests dans un contexte proche d’une vraie instance PrestaShop, plutôt que de simuler l’environnement.
Ce workflow est particulièrement adapté aux tests d’API Admin, car il permet de valider la chaîne complète : scan des ressources API Platform, routage, sécurité, sérialisation, et exécution CQRS. En pratique, vous cherchez à reproduire les conditions d’exécution (config, dépendances, modules actifs) pour éviter les faux positifs.
Enfin, n’oubliez pas les contraintes de sécurité mentionnées dans l’article « Meet the new API Platform-based API » : selon vos environnements, vous devrez ajuster le mode debug et la configuration de sécurité (ex. forcer la sécurité en debug). Les tests d’intégration doivent expliciter ces choix, sinon ils deviennent fragiles (échec local, succès CI, ou l’inverse).
5) Concevoir de bons tests d’intégration Admin API (HTTP, sécurité, données)
Un test d’intégration utile pour une API vérifie plus que le statut HTTP. Il doit couvrir : la présence de la ressource, le format de réponse (JSON-LD/Hydra si applicable), la validation des payloads, et l’effet métier observable (création/modification) en base. API Platform encourage précisément cette approche « functional tests » côté Symfony.
Comme l’Admin API PrestaShop 9 s’appuie sur OAuth, il faut intégrer des scénarios d’authentification dans les tests : absence de token (401), token sans scope/permissions (403), token valide (200/201/204). Même si votre suite de test est centrée sur ps_apiresources, l’objectif est de vérifier que la barrière de sécurité et les règles d’accès restent cohérentes d’une version à l’autre.
Concernant les données, la doc API Platform insiste sur l’usage de fixtures ou d’un état initial contrôlé. Dans le contexte PrestaShop, l’enjeu est double : stabiliser les tests (mêmes produits/attributs/catégories à chaque run) et limiter les dépendances implicites (ex. un test qui passe uniquement si la boutique contient déjà des données). Les exemples de tests d’intégration mentionnés dans la doc dev (comme AttributeGroupEndpointTest.php) servent de modèle : préparer, appeler l’endpoint, affirmer sur la réponse, puis affirmer sur l’état final.
6) Couvrir aussi l’intégration “boutique” : tests UI et scénarios module
Les tests d’intégration API ne sont pas les seuls signaux de non-régression. PrestaShop publie des scénarios de tests UI, et un scénario spécifique « ps_apiresources – Disable/Enable module » est listé comme automatisé sur les branches 9.0.x et 9.1.x, avec un lien vers le test TypeScript correspondant.
Ce type de test complète bien vos tests API Platform : il valide que le module peut être activé/désactivé proprement dans le Back-Office, que les dépendances sont cohérentes, et que l’installation ne casse pas l’instance. En pratique, une régression de packaging ou de hook peut rendre l’API indisponible, même si les tests purement HTTP passeraient sur un environnement déjà « bien installé ».
Pour une stratégie réaliste, combinez donc : (1) tests d’intégration API Platform (endpoints), (2) tests d’intégration métier (CQRS/Behat côté PrestaShop), et (3) tests UI/scénarios module (cycle de vie du module, activation, compatibilité de branches). Cette superposition de couches correspond à l’orientation officielle (CQRS Behat tested + endpoints dans ps_apiresources + scénarios automatisés).
7) Contribuer : faire évoluer les endpoints sans casser la stabilité
Les appels à contribution (2025) montrent une trajectoire claire : étendre la couverture d’endpoints Admin API, avec livraison via ps_apiresources. La mise à jour « great start! » souligne que les contributions sont activement revues et intégrées, ce qui implique un niveau d’exigence sur la qualité et la non-régression.
Pour qu’un endpoint soit durablement maintenable, les tests d’intégration doivent faire partie de la contribution. Ils servent à documenter le contrat (entrées/sorties), à verrouiller les règles de sécurité, et à prévenir les régressions de sérialisation ou de validation. C’est particulièrement important dans un contexte API Platform, où une modification d’annotation/config de ressource peut changer la forme des réponses.
La bonne pratique consiste à aligner vos tests sur les conventions existantes du module (structure tests/Integration/ApiPlatform/..., exécution via composer run-module-tests), et à viser des assertions robustes (ne pas sur-spécifier des champs instables, mais verrouiller les invariants métier). De cette façon, votre contribution s’intègre naturellement dans le pipeline et dans la dynamique communautaire décrite par PrestaShop.
La nouvelle Admin API de PrestaShop 9, basée sur API Platform, s’accompagne d’une approche testable et industrialisable : endpoints structurés en ressources, exécution CQRS, sécurité OAuth, et outillage Symfony pour les tests fonctionnels. L’existence de tests Behat sur commands/queries renforce encore l’intérêt d’ajouter une couche de tests d’intégration HTTP orientée contrat.
Le point clé pour réussir est de s’aligner sur ps_apiresources : c’est là que les endpoints vivent, que les ressources sont scannées par le Core, et que la procédure officielle de tests locaux (boutique temporaire + composer run-module-tests) permet de valider un comportement proche de la production. En combinant tests d’intégration API Platform et scénarios UI autour du module, vous obtenez une couverture pragmatique pour faire évoluer l’Admin API sans compromettre sa stabilité.

