API et documentation pour les développeurs de Northern Fitness

Northern Fitness est un détaillant canadien en ligne d’équipement d’entraînement à domicile et en salle. Cette page s’adresse aux développeurs et aux agents d’IA qui interagissent avec notre boutique par programmation : effectuer des recherches dans le catalogue, consulter les données relatives aux produits, aux prix et aux stocks, créer des paniers et finaliser les transactions avec l’approbation de l’acheteur. Tout ce qui est proposé ici est gratuit. Les points de terminaison du catalogue, de la recherche et du panier ne nécessitent ni clé API ni inscription.

Démarrage rapide

Exemples de requêtes :

curl "https://nurthernfitness.com/search/suggest.json?q=adjustable+bench&resources[type]=product"
curl "https://nurthernfitness.com/products/orion-ruck-plates.js"
curl -X POST "https://nurthernfitness.com/api/ucp/mcp" -H "Content-Type: application/application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Authentification

Les points de terminaison du catalogue, de la recherche et du panier sont publics. Les données des clients connectés (profil, adresses, historique des commandes) sont accessibles via OAuth 2.0 et les comptes clients Shopify : flux de code d’autorisation avec PKCE (S256).

Portée Autorisations
openid Connecter le client et renvoyer un jeton d’identification.
email Lire l’adresse courriel du client.
customer-account-api:full Lire et mettre à jour le profil, les adresses et les commandes du client via l’API des comptes clients.
customer-account-mcp-api:full Utiliser le serveur MCP des comptes clients au nom du client.
dev.ucp.shopping.checkout:manage Créer et gérer des transactions UCP au nom du client.
dev.ucp.shopping.catalog.search:read Effectuer des recherches dans le catalogue via UCP en tant que client.

Demandez uniquement les portées nécessaires à votre tâche.

Points de terminaison

Méthode Chemin Fonction
GET /products.json?limit=250&page=1 Lister les produits, jusqu’à 250 par page.
GET /products/{handle}.js Un produit avec ses variantes, ses prix en cents (CAD) et sa disponibilité.
GET /collections/{handle}/products.json Produits d’une collection, par exemple des haltères ou d’une marque.
GET /search/suggest.json?q= Rechercher des produits et des collections par nom, marque ou catégorie.
GET /recommendations/products.json?product_id= Produits associés ou complémentaires.
GET /cart.js Le panier actuel.
POST /cart/add.js Ajouter des variantes au panier.
POST /cart/change.js Modifier la quantité d’un article du panier.
POST /cart/update.js Mettre à jour plusieurs quantités ou la note du panier.
POST /cart/clear.js Vider le panier.
GET /.well-known/ucp Profil de découverte du protocole universel de commerce.
POST /api/ucp/mcp Serveur MCP d’achat pour agents : recherche dans le catalogue, paniers et transactions.
POST https://shopify.com/26470285361/account/customer/api/2026-10/graphql API des comptes clients (OAuth). La version actuelle est répertoriée à /.well-known/customer-account-api.
POST https://shopify.com/26470285361/account/customer/api/mcp Serveur MCP des comptes clients (OAuth).

Les schémas complets des requêtes et des réponses, avec un identifiant d’opération pour chaque point de terminaison, figurent dans la description OpenAPI.

Serveur MCP pour agents d’IA

Le serveur MCP de Northern Fitness, accessible à l’adresse https://nurthernfitness.com/api/ucp/mcp, utilise le protocole Model Context sur HTTP Streamable (JSON-RPC 2.0). Appelez tools/list pour découvrir les outils. Ceux-ci comprennent search_catalog, lookup_catalog, get_product, create_cart, update_cart, get_cart, create_checkout, update_checkout, complete_checkout, get_order, search_locations et ask_business. Les étapes d’installation et la liste complète des outils figurent sur la page Serveur MCP de Northern Fitness.

Erreurs

Les points de terminaison du catalogue et du panier renvoient des erreurs JSON contenant le code d’état HTTP, un message court et une description de la façon de corriger la requête :

HTTP 422
{"status":422,"message":"Erreur du panier","description":"Impossible de trouver la variante"}

La recherche renvoie une erreur 422 lorsque q est manquant. Les recommandations renvoient une erreur 404 avec un corps JSON lorsque l’identifiant du produit n’existe pas. Les identifiants de produit inconnus renvoient une erreur 404. Le serveur MCP renvoie des objets d’erreur JSON-RPC, par exemple {"code":-32601,"message":"Méthode introuvable"}.

Limites de débit

Si vous envoyez trop de requêtes, vous recevrez une erreur HTTP 429. Attendez le nombre de secondes indiqué dans l’en-tête Retry-After avant de réessayer. Identifiez le trafic des agents à l’aide de Web Bot Auth.

Règles applicables aux agents

  • Ne finalisez une transaction qu’avec l’approbation explicite de l’acheteur.
  • Les prix sont en dollars canadiens et les commandes sont expédiées au Canada.
  • Utilisez les points de terminaison et les outils MCP ci-dessus plutôt que de créer des scripts pour les pages de transaction.

Assistance

Questions sur l’API : support@northernfitness.ca.