Premières requêtes CRUD : lire, créer, modifier via l'API

Forcer la réponse JSON

PrestaShop retourne du XML par défaut. Pour obtenir du JSON, ajoutez le paramètre output_format=JSON à chaque requête, ou envoyez le header Accept: application/json.

Lire une liste de produits (GET)

Paramètres de filtrage disponibles :

• limit et offset pour la pagination
• filter[active]=[1] pour les produits actifs uniquement
• display=[id,name,price,quantity] pour limiter les champs retournés

Modifier un produit (PUT)

Les modifications passent par du XML, même si vous lisez en JSON. C'est le comportement natif de l'API WebService :

1. Récupérez le schéma de la ressource : GET /api/products/1?schema=blank&output_format=JSON
2. Modifiez uniquement les champs nécessaires
3. Envoyez un PUT avec le XML complet de la ressource

Les pièges à éviter

• Erreur 403 sur une ressource spécifique : vérifiez les permissions granulaires de votre clé, pas seulement son existence
• Erreur 500 silencieuse sur un module custom : vérifiez que la ressource WebService est correctement déclarée dans le module (flag $definition complet, schéma présent)
• Champs manquants dans la réponse : utilisez le paramètre display=full pour obtenir toutes les données, puis affinez avec display=[champ1,champ2]

Une intégration WebService solide commence toujours par 30 minutes de tests manuels avec curl, avant d'écrire le moindre code applicatif. Ce temps investi en amont évite des heures de debug en aval.