Si vous gérez les prix de gros en dehors de WordPress, vous pouvez faire la plupart des choses via HTTP au lieu de l'administration. L'API Wholesale Suite étend l'API REST WooCommerce afin que vous puissiez lire et écrire des produits de gros, des variations, des rôles, des remises et des analyses à partir de votre propre code. Cet article répertorie ce que chaque groupe de points de terminaison couvre, quel plugin il fournit et où trouver la référence complète.
Prérequis
- WooCommerce Wholesale Prices 1.12 ou version ultérieure. Les points de terminaison de lot nécessitent la version 1.16 ou ultérieure.
- Les points de terminaison de produits, variations et rôles de gros sont fournis avec WooCommerce Wholesale Prices, le plugin gratuit. Vous n'avez pas besoin de WooCommerce Wholesale Prices Premium pour ceux-ci.
- WooCommerce Wholesale Prices Premium 1.27 ou version ultérieure, pour les points de terminaison de remises de gros. L'API Premium est arrivée dans la version 1.25, et les points de terminaison de remises de catégorie et générales sont arrivés dans la version 1.27. Les points de terminaison d'analyse nécessitent également Premium.
- WooCommerce Wholesale Lead Capture 2.0 ou version ultérieure, pour les points de terminaison des prospects.
Wholesale Suite introduit un point de terminaison dédié : wholesale/v1/ et wwlc/v1. Ces points de terminaison vous offrent la flexibilité d'interagir avec et de gérer les aspects clés de votre programme de vente en gros de manière programmatique.
Fonctionnalités clés de l'API Wholesale Suite
- Produits de gros : listez, créez, mettez à jour ou supprimez des produits de gros. Mettez à jour plusieurs produits à la fois avec le point de terminaison de lot, wholesale/v1/products/batch, qui nécessite WooCommerce Wholesale Prices 1.16 ou version ultérieure.
- Variations de gros : listez, créez, mettez à jour ou supprimez les variations d'un produit. Le point de terminaison de lot est wholesale/v1/products/{product_id}/variations/batch.
- Rôles de gros : listez et mettez à jour les rôles qui contrôlent qui obtient quels prix. Le plugin gratuit fournit un rôle de gros, et Premium ajoute la création et la suppression.
- Prospects de gros : listez, créez, mettez à jour ou supprimez les prospects de gros. Ces points de terminaison sont fournis avec WooCommerce Wholesale Lead Capture et utilisent l'espace de noms wwlc/v1.
- Remises de gros : lisez et définissez des remises au niveau de la catégorie et des remises générales via les points de terminaison category-discount et general-discount. Ceux-ci nécessitent WooCommerce Wholesale Prices Premium 1.27 ou version ultérieure.
- Analyses de gros : récupérez les métriques de ventes de gros pour les produits, les clients ou les achats de gros généraux. Ceux-ci se trouvent dans leur propre espace de noms, wholesale/v1/analytics, et nécessitent Premium.
Pourquoi utiliser l'API Wholesale Suite
Cette intégration d'API rend la gestion de votre boutique en gros plus flexible et transparente, surtout si vous avez besoin d'automatiser ou de synchroniser vos données en gros avec d'autres systèmes ou plateformes. Que vous gériez de grands catalogues, ajustiez des prix en masse ou personnalisiez des rôles d'utilisateurs, cette API vous permet de tout faire sans avoir à ajuster manuellement chaque paramètre dans votre tableau de bord d'administration.
Premiers pas avec l'API Wholesale Suite
Pour interagir avec l'API Wholesale Suite, utilisez l'authentification de l'API REST WordPress et les verbes HTTP standard (GET, POST, PUT, DELETE). Vous pouvez intégrer cette fonctionnalité à toute plateforme ou système prenant en charge les requêtes API basées sur HTTP.
Pour des détails complets sur l'utilisation de l'API Wholesale Suite, y compris les méthodes disponibles, les paramètres et les exemples de requêtes, veuillez consulter la documentation complète de l'API.
Liste blanche des actions déclenchées par l'API REST
Wholesale Suite dispose d'un deuxième point de terminaison pour exécuter des actions de maintenance, telles que la suppression des caches de produits. Il se trouve dans l'espace de noms wwp/v1, et non wholesale/v1, il est donc facile de le manquer.
Envoyez une requête POST à /wp-json/wwp/v1/admin/action avec une valeur action dans le corps. La requête nécessite un accès administrateur.
Chaque nom d'action doit figurer sur une liste d'autorisation. S'il n'y figure pas, la réponse renvoie un statut d'erreur et le message Action invalide. Une action autorisée exécute son gestionnaire et renvoie un statut et un message.
Ces noms d'action sont disponibles lorsque le plugin correspondant est actif :
- WooCommerce Wholesale Prices Premium: clear_var_prod_price_range_caching, clear_product_caching, clear_unused_product_meta, initialize_product_visibility_meta, force_fetch_update_data
- WooCommerce Wholesale Lead Capture: force_fetch_update_data, create_lead_pages
- WooCommerce Wholesale Order Form: schedule_database_optimization
Pour ajouter votre propre action, enregistrez-la avec le filtre wwp_allowed_trigger_actions en PHP. Wholesale Suite récupère également tout hook dont le nom commence par wwp_trigger_ et traite le reste du nom comme une action autorisée. Vous ne pouvez pas ajouter un nom d'action via l'API REST elle-même.
add_filter( 'wwp_allowed_trigger_actions', function ( $actions ) {
$actions[] = 'my_custom_action';
return $actions;
} );
add_filter( 'wwp_trigger_my_custom_action', function ( $params ) {
// Run your task here.
return array(
'status' => 'success',
'message' => 'Custom action finished.',
);
} );Il existe une deuxième liste d'autorisation distincte pour les actions de configuration de groupe. Elle utilise le filtre wwp_allowed_group_actions et s'exécute sur le point de terminaison d'enregistrement des paramètres, /wp-json/wwp/v1/admin/save. Si votre action enregistre des paramètres, elle doit plutôt figurer sur cette liste.
Aide et Support
Nous avons une équipe de support dédiée pour Wholesale Suite qui connaît très bien nos produits, WooCommerce et le secteur. Vous êtes invité à utiliser leur expertise à tout moment, partout dans le monde.
Si vous êtes un client existant, veuillez vous rendre sur le formulaire de demande de ticket de support et envoyez-nous un message.
Si vous êtes un utilisateur de plugin gratuit, veuillez nous envoyer une demande de support sur le forum. Nous surveillons activement les forums de support de WordPress.org pour le plugin gratuit et aidons nos utilisateurs du mieux que nous pouvons.
