API produits WooCommerce pour agents IA
Exposez un catalogue WooCommerce compact et en lecture seule pour la découverte, la recherche filtrée et la vérification produit, sans publier d’identifiants REST administratifs.
La réponse directe
KaliCart Bridge publie une couche publique de lecture des produits sur le domaine marchand. Un agent compatible découvre l’interface, recherche des résumés paginés et vérifie les détails actuels d’un produit sélectionné. Les écritures restent exclues.
Pourquoi ne pas donner l’API REST WooCommerce ?
L’API REST est large et utilise généralement des identifiants. Un agent public a besoin d’un contrat plus petit : découvrir, rechercher économiquement, vérifier une offre et suivre l’URL d’achat canonique.
Flux de requêtes
1. Découvrir les capacités
Lire les points d’entrée et consignes publiques.
2. Rechercher des fiches compactes
Texte, catégorie et pagination réduisent les candidats.
3. Vérifier un candidat
Identité, prix, stock et variantes sont contrôlés dans WooCommerce.
4. Respecter les signaux
Erreurs, plafonds et Retry-After guident correction ou attente.
5. Revenir au magasin canonique
Options, livraison, taxes et paiement restent chez le marchand.
Données destinées aux décisions produit
| Signal | Utilité |
|---|---|
| Identité stable | ID, SKU et URL canonique distinguent les candidats. |
| Classification | Noms, catégories, marques et attributs soutiennent recherche et comparaison. |
| Offre | Prix, devise et stock reflètent la publication WooCommerce actuelle. |
| Variantes | La réponse indique quand une sélection précise reste nécessaire. |
| Limite d’action | État d’achat et liens montrent quand le marchand doit reprendre la main. |
Accès catalogue borné
- Lecture seule, sans endpoints clients, commandes ou administration.
- Pagination et tailles maximales empêchent une requête du catalogue entier.
- Les résumés réduisent tokens, bande passante et travail serveur.
- Les signaux de limite permettent d’attendre et réessayer.
- WooCommerce reste la source actuelle de référence.
API, flux et MCP sont des couches différentes
| Surface | Usage adapté |
|---|---|
| Flux produit | Soumission en masse selon le format d’une plateforme. |
| API catalogue Bridge | Découverte en direct et vérification sélective. |
| Serveur MCP | Découverte et invocation d’outils par les clients MCP. |
| Checkout WooCommerce | Options, livraison, taxes, paiement et transaction. |
Solutions associées
Commerce agentique pour WooCommerce
Replacez l’API dans le parcours jusqu’au checkout marchand.
Flux plateformeFlux produits ChatGPT pour WooCommerce
Utilisez le flux séparé pour la soumission en masse.
Questions fréquentes
- L’API exige-t-elle des clés consumer WooCommerce ?
- Non pour les routes publiques de lecture Bridge. Elles exposent des données commerciales publiques et bornées sans autorité administrative.
- Un agent peut-il modifier un produit ou créer une commande ?
- Non. L’interface catalogue Bridge est en lecture seule. L’administration et les commandes restent hors du contrat public.
- Un agent peut-il télécharger tout le catalogue en une requête ?
- Non. Recherche et listes sont paginées et limitées. Il faut réduire les candidats avant de demander le détail.
- Est-ce identique à un flux produit ?
- Non. Un flux sert à la soumission en masse ; l’API permet des requêtes sélectives et actuelles sur le domaine marchand.
- Est-ce un serveur MCP ?
- Non. C’est l’interface commerciale en lecture seule pour agents et intégrations. KaliCart fournit une surface MCP distincte.
- Que se passe-t-il quand la limite est atteinte ?
- La boutique peut renvoyer une réponse de limitation avec une consigne de nouvelle tentative. Un agent conforme attend le délai indiqué.
