Premier échange gratuit de 15 minutes, directement avec nos experts.
L’Admin API est l’interface qui permet de piloter Shopware 6 depuis l’extérieur : produits, stocks, commandes, clients et paramètres peuvent être lus et modifiés. C’est la voie standard pour connecter un ERP, un PIM, un CRM ou un middleware à la boutique, y compris pour les e-commerçants en France qui relient Shopware à leur gestion commerciale.
Tout ce que vous pouvez faire dans l’administration de Shopware 6 peut aussi se faire via l’Admin API : créer des produits, modifier des stocks, lire des commandes, mettre à jour des clients, déclencher des changements de statut. L’administration elle-même n’est qu’un client de cette API ; chaque action dans le back-office est un appel d’API.
C’est précisément pour cela que l’Admin API est la voie standard pour connecter des systèmes tiers. ERP, PIM, gestion commerciale, CRM et middleware dialoguent avec Shopware via cette interface, le plus souvent en arrière-plan et sans intervention d’un utilisateur. Elle repose sur REST, renvoie du JSON et donne accès à toutes les entités du Data Abstraction Layer.
Shopware 6 propose deux interfaces, souvent confondues :
/api/.sw-access-key, endpoints sous /store-api/.Règle simple : ce qu’un collaborateur fait dans l’administration relève de l’Admin API. Ce qu’un client fait dans la boutique relève de la Store API. Les différences en détail sont expliquées dans notre article sur GraphQL et les API REST dans Shopware.
L’accès passe par OAuth 2.0. Pour les intégrations système, créez sous Paramètres → Système → Intégrations une intégration avec son propre rôle : vous obtenez un ID de clé d’accès et une clé de sécurité. Vous demandez ensuite un jeton :
POST /api/oauth/token
{
"grant_type": "client_credentials",
"client_id": "VOTRE_ID_CLE_ACCES",
"client_secret": "VOTRE_CLE_SECURITE"
}
Le jeton est valable dix minutes et s’envoie dans l’en-tête Authorization: Bearer. Pour les outils qui agissent au nom d’un utilisateur, il existe en plus le type d’autorisation password avec jeton de rafraîchissement. N’accordez à chaque intégration que les droits dont le processus a besoin ; les rôles ACL permettent de restreindre l’accès jusqu’à des entités et opérations précises. Pour en savoir plus sur le protocole, consultez l’article OAuth.
GET /api/product, POST /api/product, PATCH /api/product/{id}, DELETE /api/product/{id}, et de même pour les commandes, clients, catégories, médias et toutes les autres entités.POST /api/search/product avec filtres, tri, pagination, agrégations et associations. Vous chargez par exemple toutes les commandes d’une journée, lignes comprises, en un seul appel.POST /api/_action/sync écrit de nombreux enregistrements de plusieurs entités en une seule requête. C’est la bonne méthode pour synchroniser stocks et prix sur des milliers d’articles./api/_action/order/{id}/state/…), génération de documents, envoi d’e-mails, lancement de l’indexation./api/_info/ renvoie la version, les entités disponibles et le schéma OpenAPI ; l’interface Swagger sous /api/_info/swagger.html documente tous les endpoints.Dans une intégration ERP typique, par exemple avec Sage, Cegid ou Divalto, très répandus en France, l’Admin API prend en charge les flux suivants :
Plutôt que d’interroger Shopware à intervalles réguliers, vous pouvez vous faire notifier : les webhooks signalent les nouvelles commandes ou les produits modifiés, et l’intégration ne charge alors que ce qui a changé. Notre présentation des intégrations ERP et CRM montre quels systèmes peuvent être connectés ainsi, et le guide Xentral et Shopware 6 en donne un exemple concret.
updatedAt ou des webhooks, vous ne transmettez que les deltas au lieu de tout le stock.indexing-behavior: use-queue-indexing permet de déporter l’indexation dans la file d’attente.L’Admin API est la colonne vertébrale de toute intégration Shopware. En maîtrisant sa logique, OAuth 2.0, recherche avec critères, Sync API et State Machine, vous connectez ERP, PIM et CRM de façon fiable. Pour les connexions sur mesure et les plugins qui ajoutent vos propres endpoints à l’Admin API, nous accompagnons les e-commerçants en France avec notre développement de plugins Shopware, par téléphone au +49 421 438 1919-0.