Création PrestaShop : adoptez l’Admin API pour des intégrations modernes

La sortie de PrestaShop 9 marque un tournant pour les intégrations e‑commerce : une Admin API entièrement refondue, construite sur API Platform, est désormais au cœur de la plateforme. Cette nouvelle API vise à faciliter les connexions avec des CRM, ERP, outils marketing et automatisations, en proposant des standards modernes et une documentation automatique.

Si vous créez ou maintenez des stores PrestaShop, adopter l’Admin API est une opportunité pour moderniser vos flux de données, gagner en sécurité et en maintenabilité, et profiter d’un écosystème contributif actif. La documentation a été mise à jour récemment (15/01/2026) et l’API évolue rapidement grâce à la communauté.

Pourquoi cette Admin API change la donne

PrestaShop 9 introduit « une toute nouvelle Admin API » basée sur API Platform (v3 dans PS9), apportant des fonctionnalités avancées de content negotiation et un socle solide pour construire des intégrations robustes. L’utilisation d’API Platform permet notamment de proposer JSON‑LD par défaut et d’étendre le support à JSON:API, GraphQL, HAL ou OpenAPI selon les besoins.

Cette approche moderne facilite la compatibilité avec des outils existants et réduit le travail d’adaptation côté intégrateur. Par ailleurs, l’API est conçue pour couvrir les opérations CRUD standards (ex. GET/PUT/POST/DELETE pour /admin-api/customers/group/{id}), avec des réponses JSON claires et des exemples concrets dans la doc.

Le message produit officiel résume bien l’enjeu : « PrestaShop 9 brings a major innovation with a completely new Admin API based on API Platform. » Cette étape importante ouvre la voie à des intégrations plus propres, testables et évolutives.

Sécurité et authentification

L’Admin API utilise OAuth2 pour l’authentification, avec la possibilité d’un serveur d’autorisation interne ou externe. Les accès s’effectuent via tokens Bearer et des scopes fins (par exemple product_read, product_write, cart_rule_write…), permettant de restreindre précisément les privilèges des clients API.

En pratique, les exemples curl fournis dans la documentation montrent l’usage du er : Authorization: Bearer YOUR_ACCESS_TOKEN. En production, la documentation impose HTTPS/TLS ; il existe cependant des options pour assouplir les vérifications TLS en mode debug, et des paramètres comme « Force security in debug mode » demandent une attention particulière lors de l’activation.

Pour les intégrateurs, cela signifie deux règles simples : limiter les scopes, et stocker les tokens de façon sécurisée côté client. La doc recommande aussi d’utiliser des flux OAuth2 standard et de prévoir des mécanismes de rotation/revocation des tokens en production.

Documentation, OpenAPI et outils développeur

Une des forces de l’Admin API est la génération automatique de documentation et de schémas OpenAPI. Vous pouvez accéder à la collection OpenAPI via /admin-api/docs.json et à la vue HTML interactive via /admin-api/docs., ce qui facilite l’import dans Postman, Insomnia ou d’autres outils API.

La doc développeur a été mise à jour le 15/01/2026 (auteur Krystian Podemski) et précise les endpoints, les scopes et des exemples pratiques, comme la récupération des informations d’un API client via /admin-api/api-client/infos qui retourne la liste des scopes (api_client_read, product_read, module_write…).

L’automatisation des tests et l’intégration continue sont nativement soutenues : ps_apiresources et les tests API font l’objet de CI/PRs actives, et les notes de release montrent un cycle de stabilisation (par ex. PrestaShop 9.0.2 avec 49 corrections de bugs et 118 pull requests).

Extensibilité et modularité avec ps_apiresources

La définition et l’évolution des endpoints sont externalisées dans le module ps_apiresources, ce qui permet d’ajouter ou de modifier des endpoints sans attendre une release core. C’est une excellente nouvelle pour les développeurs qui souhaitent enrichir l’API selon des besoins métiers spécifiques.

Concrètement, vous pouvez créer de nouveaux endpoints, définir des scopes et faire évoluer les ressources via le module, puis soumettre des contributions. Le processus est ouvert : PrestaShop a lancé un « Call for contributions: Admin API » avec un canal Slack dédié, des labels GitHub et une revue de contributions pour intégrer les apports communautaires.

Cette modularité facilite aussi la maintenance : corriger un endpoint ou ajouter une ressource peut passer par une PR ciblée sur ps_apiresources, accélérant le déploiement des améliorations et la stabilisation grâce à la CI.

Cas d’usage concrets pour les intégrateurs

L’Admin API couvre des scénarios opérationnels variés : synchronisation clients/commandes/paniers vers ESP/CRM/CDP, automatisation marketing (ex. abandon de panier + génération automatique d’un coupon), ou intégration d’ERP pour mises à jour massives de stocks et prix.

Les endpoints CRUD illustrés dans la documentation (ex. GET /admin-api/customers/group/{id}, PUT /admin-api/customers/group/{id}, POST /admin-api/customers/group, DELETE /admin-api/customers/group/{id}) montrent comment piloter ces flux de façon standardisée. Ces exemples facilitent l’automatisation et la surveillance des échanges entre PrestaShop et vos systèmes métiers.

En combinant des webhooks, des jobs côté intégrateur et les scopes fins de l’API, on peut bâtir des synchronisations temps réel ou différées, tout en conservant un contrôle granulaire sur les permissions et la sécurité.

Bonnes pratiques pour une intégration en production

Avant tout déploiement, vérifiez que l’Admin API est activée : dans PrestaShop 9 elle est « enabled by default », cependant certaines pages d’aide historiques montrent encore l’activation via Paramètres avancés → Nouveautés & fonctionnalités expérimentales ; prenez garde aux options en mode debug.

En production, imposez HTTPS/TLS et gérez les tokens avec prudence : stockez-les dans un vault ou un stockage chiffré côté intégrateur, limitez les scopes et implémentez la rotation et la révocation. Évitez d’exposer des tokens longue durée sans mécanisme de revalidation.

Enfin, testez vos intégrations via la collection OpenAPI (/admin-api/docs.json) et dans des environnements CI. Suivez les releases et changelogs (ps_apiresources, 9.0.0 → 9.0.2) pour rester aligné sur les corrections de bugs et les améliorations fonctionnelles.

À l’heure où l’e‑commerce exige flexibilité et sécurité, adopter l’Admin API de PrestaShop 9 est un levier pour moderniser vos intégrations et réduire la dette technique. Le socle API Platform, la documentation OpenAPI et la modularité via ps_apiresources rendent le développement plus rapide et collaboratif.

Contribuez : PrestaShop invite la communauté via le Call for Contributions et un suivi actif des PRs pour enrichir l’API. Consultez la documentation officielle (How to use / Admin API , DevDocs), testez /admin-api/docs.json et /admin-api/docs., puis participez sur GitHub pour façonner l’avenir de l’ Admin API .