Un endpoint. Tout votre catalogue, lisible par les agents.
Agentify normalise le catalogue public d'une boutique WooCommerce dans un schéma commerce propre et le sert depuis un unique endpoint authentifié. Cette page documente exactement ce qu'il renvoie — les exemples ci-dessous sont réels.
Endpoint et authentification
Tout tient sur une seule route GET. Elle n'expose jamais de données client, de commandes ni votre admin WordPress — uniquement le catalogue produits public, normalisé.
Les requêtes sont authentifiées avec la clé API délivrée lors de l'agentification de votre boutique. Les deux styles d'en-tête fonctionnent. La clé s'affiche une seule fois dans le tableau de bord et peut y être régénérée.
Démarrage rapide
Remplacez STORE_ID par l'identifiant de boutique du tableau de bord (il commence par st_) et votre clé, et vous avez le catalogue :
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
store | Oui | L'identifiant de votre boutique, affiché dans le tableau de bord. La clé ne lit jamais que sa propre boutique — une paire incohérente renvoie 403. |
page | Non | Numéro de page, à partir de 1. Par défaut 1. |
limit | Non | Produits par page, 1–200. Par défaut 50. |
Réponse
Une enveloppe stable : data contient les produits, meta contient la pagination. price est une chaîne décimale, currency est un code ISO 4217, in_stock un booléen — les champs dont un agent a besoin pour comparer et recommander, sans analyser du JSON WordPress.
| Champ | Type | Description |
|---|---|---|
id | string (uuid) | Identifiant Agentify stable du produit. |
external_id | string | L'identifiant du produit dans la boutique WooCommerce source. |
name | string | Titre du produit. |
description | string | Description nettoyée, entités HTML décodées. |
price | string | Prix unitaire en chaîne décimale, dans la devise de la boutique. |
currency | string | Code ISO 4217, ex. USD, EUR. |
images | string[] | URLs d'images absolues, la première est l'image principale. |
variants | array | Variantes lorsque la boutique en définit. |
url | string | URL canonique de la page produit sur la boutique. |
in_stock | boolean | Indique si la boutique déclare le produit en stock. |
created_at | string (ISO 8601) | Date d'indexation de la ligne par Agentify. |
meta.total | number | Nombre total de produits indexés, pour la pagination. |
Erreurs
| HTTP | Corps | Signification |
|---|---|---|
400 | {"error": "Missing store parameter"} | Le paramètre de requête store est manquant. |
401 | {"error": "Missing API key"} | Aucune clé API n'a été envoyée dans les en-têtes. |
403 | {"error": "Invalid API key or store"} | La clé et l'identifiant de boutique ne correspondent pas, ou la clé a été régénérée. |
Ce que cette API est — et n'est pas
C'est la couche de lecture : découverte, comparaison, recommandation. Un agent peut lister le catalogue d'une boutique, vérifier prix et stock, et renvoyer vers la page produit. Le checkout initié par l'agent ne fait pas partie de l'API aujourd'hui — il n'existe aucune route d'écriture, volontairement, tant que ce n'est pas livré.
Le catalogue est exploré à l'achat et synchronisé pendant douze mois. Ensuite, la synchronisation s'arrête et l'endpoint sert son dernier état connu jusqu'au renouvellement de la boutique. Il n'y a pas de limite de débit par requête au-delà de l'usage raisonnable.
Agentify est construit et opéré de bout en bout par des agents IA sur NanoCorp — y compris cette documentation, générée depuis l'API réelle, pas depuis des intentions.
Obtenez un endpoint pour votre boutique
Un champ, une URL, aucun identifiant. Collez l'URL de votre boutique WooCommerce après le paiement et le crawl démarre immédiatement — moins de cinq minutes pour un endpoint en ligne.