Index des Recettes Management
Qu'est-ce que les Recettes Management ?
Les recettes management s'appliquent aux opérations REST API qui configurent, installent et gèrent les entités métier Wix sur votre site. Ces recettes utilisent des appels REST API et sont conçues pour :
- Configuration et setup du site — Configuration initiale de magasins, réservations, paiements et autres applications métier
- Gestion d'entités — Création, mise à jour et suppression de produits, services, membres du personnel, plans tarifaires
- Opérations administratives — Mises à jour en masse, étiquetage de contacts, migrations de données
- Intégrations backend — Automations serveur-à-serveur, webhooks, synchronisation de données
Ces recettes ne couvrent PAS le développement frontend ou l'utilisation du SDK pour afficher des données aux utilisateurs.
Installation d'Applications
Installer des Applications Wix
Technique : Installe les applications Wix sur un site en utilisant l'API Apps Installer. Couvre l'activation de Velo (Wix Code), l'installation d'applications et les ID de définition d'applications courants.
Lister les Applications Installées
Technique : Liste toutes les applications installées sur un site en utilisant l'API Apps Installer. Utile pour vérifier les installations avant d'effectuer des appels API et diagnostiquer les erreurs d'autorisation.
Blog
Comment Créer des Articles de Blog
Technique : Crée et publie des articles de blog en utilisant l'API Blog Posts. Couvre le format de contenu enrichi Ricos, l'upload d'images via Media Manager, l'assignation de catégories/tags et la création en masse d'articles.
Réservations
Configuration de la Politique de Service de Réservation
Technique : Configure les politiques de réservation, les règles d'annulation et la configuration de liste d'attente en utilisant les champs de politique de l'API Services. Couvre les paramètres bookingPolicy, cancellationPolicy et waitlist.
Lacunes d'Intégration du Système de Réservation
Technique : Documente les motifs API non documentés pour les paiements de réservation. Couvre l'intégration Réservations→Ecommerce, la transformation d'ID de réservation en articles de catalogue et les flux de confirmation de paiement asynchrones.
Configuration du Personnel de Réservation
Technique : Crée des membres du personnel et configure des heures de travail personnalisées en utilisant l'API Staff + l'API Calendar Events. Processus critique en deux étapes : créer le personnel → assigner l'emploi du temps → créer des événements d'heures de travail.
Créer et Mettre à Jour les Services de Réservation
Technique : Opérations CRUD complètes pour les services Wix Bookings en utilisant l'API Services. Couvre les types de services (APPOINTMENT, CLASS, COURSE), la configuration des tarifs, la configuration des emplacements et la gestion des horaires.
Flux de Réservation Complet
Technique : Flux complet de réservation de la découverte de service au paiement. Requêter les services, vérifier la disponibilité avec Time Slots V2, créer des réservations et traiter le paiement via le checkout eCommerce.
Intégration de Calendrier Externe
Technique : Intégration basée sur OAuth avec Google Calendar, Microsoft Outlook et Apple Calendar. Couvre les flux d'authentification, la configuration de synchronisation et la gestion bidirectionnelle des événements.
Création de Service Multi-Ressource
Technique : Crée des types de ressources et des ressources individuelles en utilisant l'API Resources. Permet les services qui nécessitent plusieurs ressources (salles + équipement + personnel) avec allocation automatique.
Calendrier
Configurer les Heures de Travail par Défaut
Technique : Utilise l'API Calendar Events pour créer des événements WORKING_HOURS sur l'horaire professionnel. Couvre la distinction critique entre l'API Calendar Events (correcte) et l'API Site Properties (incorrecte) pour définir la disponibilité de base.
CMS
CRUD des Éléments de Données CMS
Technique : Ajouter, requêter, mettre à jour et supprimer des éléments dans les collections CMS. Utilisez ceci pour insérer du contenu, insérer/mettre à jour/patcher/supprimer en masse des éléments, requêter avec filtres et gérer les données de collection. Points de terminaison clés : /wix-data/v2/items, /wix-data/v2/bulk/items/*.
Opérations de Données CMS Étendues
Technique : Opérations supplémentaires de données CMS incluant le comptage, l'upsert (sauvegarde en masse) et les motifs de mise à jour par filtre.
Intégration du Catalogue eCommerce CMS
Technique : La méthode recommandée pour vendre les articles de collection CMS existants (tickets, réservations, abonnements) via le checkout Wix. Ajoutez le plugin CATALOG pour convertir n'importe quelle collection CMS en produits achetables avec intégration du panier et du paiement.
Références et Relations CMS
Technique : Ajouter, remplacer ou supprimer des éléments des champs MULTI_REFERENCE. Utilisez les points de terminaison insert-references, replace-references, remove-references. Requis pour gérer les relations multi-références — elles NE PEUVENT PAS être définies via les opérations insert/update/patch régulières. Couvre également les références uniques et les requêtes avec références développées.
Gestion du Schéma CMS
Technique : Créer et modifier les structures de collection CMS. Couvre l'énumération des collections, la création de collections avec des champs, l'ajout/suppression de champs et la mise à jour des paramètres de collection.
Contacts
Suppression en Masse de Contacts
Technique : Supprime plusieurs contacts en utilisant la suppression en masse basée sur filtre. Couvre les motifs de suppression sûrs, la conformité GDPR, les alternatives de suppression progressive et les stratégies de traitement par lots.
Étiqueter et Retirer les Étiquettes des Contacts en Masse
Technique : Ajoute/retire des étiquettes à plusieurs contacts en utilisant les opérations en masse de l'API Contacts. Couvre la création d'étiquettes, le filtrage de contacts, le traitement par lots et la gestion des limites de taux.
Domaines
Recherche et Achat de Domaine
Technique : Recherchez les domaines disponibles, obtenez des suggestions de domaine et générez des liens d'achat en utilisant l'API Domain Search V2. Couvre les vérifications de disponibilité, le filtrage TLD et la connexion de domaines aux sites Wix.
eCommerce
Recette : Appliquer les Recommandations d'Expédition
Technique : Applique les recommandations d'expédition générées par IA à un magasin ecommerce Wix. Lit le profil de livraison et les options d'expédition actuels, puis crée ou met à jour les options d'expédition en fonction des données de recommandation. Supporte la création de nouvelles options avec tarifs conditionnels, la mise à jour des options existantes et l'interrogation des profils de livraison pour le contexte région/transporteur.
Configuration de l'Emplacement de Retrait en Magasin
Technique : Configure une option de retrait pour un magasin en ligne afin que les clients puissent choisir le retrait en magasin au moment du paiement. Utilise l'API Delivery Profiles pour découvrir le transporteur Pickup, ajouter une région de livraison et attacher le transporteur avec un tarif de retrait gratuit.
Événements
Lister les Événements
Technique : Requête des événements de Wix Events en utilisant l'API Events. Couvre les ensembles de champs (DETAILS, URLS, REGISTRATION), le filtrage par statut/date et la pagination.
Formulaires
Créer un Formulaire
Technique : Crée un formulaire avec des champs (nom, email, etc.) en utilisant l'API Form Schemas. Couvre la configuration des champs, la mise en page et les déclencheurs post-soumission.
Recevoir des Paiements
Créer des Liens de Paiement
Technique : Crée des liens de paiement pour collecter les paiements sans flux de paiement. Couvre les produits de magasin (articles de catalogue), les articles de ligne personnalisés, les variantes, les dates d'échéance et l'envoi de liens par email.
Comment Configurer Wix Payments
Technique : Configure Wix Payments comme fournisseur de paiement. Couvre la vérification de l'éligibilité, la vérification d'entreprise, la configuration du compte bancaire et la configuration des méthodes de paiement (cartes, PayPal, Apple Pay).
Liens de Paiement pour les Réservations
Technique : Crée des liens de paiement pour les réservations non payées en utilisant l'API Payment Links. Lie les ID de réservation aux demandes de paiement avec gestion appropriée des redirections.
Média
Télécharger des Médias vers Wix
Technique : Télécharge des images et des fichiers vers le Media Manager Wix en utilisant l'API Import File. Couvre l'importation à partir d'URL externes, la vérification de l'état du fichier et l'utilisation de l'URL wixstatic.com retournée dans d'autres APIs.
Plans Tarifaires
Créer et Mettre à Jour les Plans Tarifaires
Technique : Crée des plans d'abonnement et de paiement unique en utilisant l'API Plans. Couvre les modèles tarifaires (récurrents, paiement unique, gratuit), les périodes d'essai, la configuration des avantages et la visibilité du plan.
Intégration des Plans Tarifaires aux Réservations
Technique : Lie les Plans Tarifaires aux services Bookings en utilisant l'API Benefit Programs. Permet les forfaits et abonnements qui accordent l'accès aux réservations.
Restaurants
Configuration de Wix Restaurants
Technique : Configure les menus de restaurant, les sections et les articles en utilisant l'API Menus. Couvre la structure de menu (Menu → Section → Article), les modificateurs, la tarification, les horaires de disponibilité et les paramètres de commande.
Contenu Enrichi
Service de Conversion Ricos
Technique : Valide et convertit le contenu entre les documents Ricos et HTML/Markdown/texte brut en utilisant l'API Ricos Documents. Couvre la configuration des plugins, la conversion de format dans les deux directions et la validation de documents.
Propriétés du Site
Changer la Devise de Paiement
Technique : Met à jour la devise de paiement au niveau du site (devise de facturation du magasin) en utilisant l'API Site Properties, y compris la forme de corps de requête requise et le masque de champ.
Sites
Créer un Site à partir d'un Modèle
Technique : Crée de nouveaux sites Wix à partir de modèles en utilisant les APIs au niveau du compte. Couvre la recherche de modèles, la création de site, la configuration de site headless, la création d'application OAuth et la publication.
Requête de Sites
Technique : Liste et requête tous les sites associés à un compte Wix en utilisant l'API Sites. Couvre la pagination avec navigation basée sur curseur.
Magasins
Ajouter des Pages de Magasin au Site
Technique : Ajoute les pages de paiement et de panier manquantes à un site lorsque l'application Stores est installée. Utilisé lorsque les pages de magasin manquent après une migration ou des problèmes de setup.
Créer en Masse des Produits avec Options
Technique : Utilise le point de terminaison de produits en masse pour créer plusieurs produits avec inventaire en une seule requête. Gère la génération de variantes à partir d'options, les exigences de format de média et la gestion des erreurs pour les défaillances partielles.
Créer un Produit à partir d'une Image (Version Router)
Technique : Point d'entrée OBLIGATOIRE pour tous les flux « créer un produit à partir d'une image ». Détecte la version de catalogue du site en utilisant le point de terminaison Get Catalog Version, puis route vers la recette spécifique à la version correcte (V1 ou V3). Commencez toujours ici lorsque l'utilisateur souhaite créer un produit à partir d'une image.
Créer un Produit à partir d'une Image (Catalogue V1)
Technique : Crée un produit en téléchargeant une image vers Wix Media, en utilisant le LLM pour générer le nom, la description et le prix du produit à partir de l'image, puis en attachant le média au produit créé. Combine Upload de Média + analyse LLM + Création de Produit + Ajouter Media de Produit en un seul flux. Catalogue V1 uniquement — pour les sites V3, utilisez plutôt Créer un Produit à partir d'une Image (Catalogue V3).
Créer un Produit à partir d'une Image (Catalogue V3)
Technique : Crée un produit en analysant une image avec le LLM pour générer le nom, la description et le prix du produit, puis crée le produit avec l'image attachée en ligne dans un seul appel API. Utilise l'API Catalogue V3 avec des nœuds de texte enrichi et des médias en ligne. Catalogue V3 uniquement — pour les sites V1, utilisez plutôt Créer un Produit à partir d'une Image (Catalogue V1).
Créer un Produit (Catalogue V1)
Technique : Crée des produits en utilisant l'API Catalog V1 Products. Utilisez cette recette lorsque la version de catalogue du site est CATALOG_V1. Couvre la création simple de produits, le produit avec options et les différences clés de la structure de requête V1 par rapport à V3.
Créer un Produit avec Options (Catalogue V3)
Technique : Création d'un seul produit avec options en utilisant l'API Catalog V3 Products. Couvre les types d'options (TEXT_CHOICES, SWATCH_CHOICES), la configuration des choix et la génération automatique de variantes.
Trouver des Produits (Requête et Recherche, Catalogue V3)
Technique : Trouvez, cherchez, requêtez et listez les produits d'un Magasin Wix en utilisant les points de terminaison Catalog V3 Search Products et Query Products. Explique quand utiliser chaque point de terminaison, les valeurs correctes de l'énumération des champs, le filtrage, le tri et la pagination.
Requête de Produits (Catalogue V1)
Technique : Requête et liste les produits d'un Magasin Wix en utilisant le point de terminaison Catalog V1 Query Products. Utilisez cette recette lorsque la version de catalogue du site est CATALOG_V1. Couvre les requêtes de base, le filtrage, le tri et la pagination.
Configuration du Magasin en Ligne (Catalogue V3)
Technique : Initialise un catalogue Stores avec l'API Catalog V3 Products, le point de terminaison de produits en masse et l'API Categories. Couvre la création de produits, la configuration d'options, la gestion des variantes et l'assignation de catégories.
Mettre à Jour la Pré-Commande de Produit
Technique : Gère les paramètres de pré-commande pour les variantes de produits en utilisant l'API V3 Inventory. Couvre l'activation/désactivation des pré-commandes, la configuration des messages, la configuration des limites et la gestion des exigences de trackQuantity.
Mettre à Jour un Produit avec Options
Technique : Modifie les produits et variantes existants en utilisant l'API Catalog V3 Products. Couvre l'ajout/suppression de choix d'options, la tarification spécifique à la variante et les mises à jour basées sur la révision pour éviter les conflits.