← Se connecter

Crown Sport Nutrition · Documentation technique

API Marché France

Accès en lecture seule aux commandes, aux clients et à l'analytique d'acquisition du marché français de la boutique Shopify de Crown Sport Nutrition.

  • Base : https://hts.crownsportnutrition.fr/api
  • Lecture seule
  • Périmètre : France uniquement

01Authentification

Deux en-têtes équivalents, au choix. Les jetons commencent par csn_, sont nominatifs et révocables à tout moment.

En-têtes
Authorization: Bearer csn_xxxxxxxxxxxxxxxxxxxx
X-API-Key: csn_xxxxxxxxxxxxxxxxxxxx
Exemple
curl -H "Authorization: Bearer csn_xxxx" \
     "https://hts.crownsportnutrition.fr/api/summary?period=30d"

Les jetons sont délivrés par Crown ; ils ne s'auto-génèrent pas. Un jeton ne doit pas être partagé entre plusieurs personnes ni committé dans un dépôt de code : en cas de fuite, la révocation coupe l'accès de tout le monde.

02Conventions

FormatJSON (UTF-8), sauf format=csv
DatesISO-8601 en UTC. L'interface web les affiche en heure de Paris
MontantsNombres, en euros
Paginationpage (1..n) et page_size (1..250)
Date de commandeDate d'achat, et non la date de création de la fiche dans Shopify

Ce dernier point compte pour l'historique. Les commandes reprises de l'ancien site WooCommerce ont été créées dans Shopify en bloc, à une date qui n'a rien à voir avec celle de l'achat. L'API renvoie toujours la date d'achat réelle ; c'est elle qui sert au tri et aux filtres from / to.

03Points d'entrée

Neuf points d'entrée, tous en lecture. Aucun ne modifie quoi que ce soit.

GET/api

Index auto-descriptif : liste les points d'entrée et leurs paramètres. Utile pour vérifier la version en ligne sans relire ce document.

GET/api/summary

Indicateurs de la période, répartition et série quotidienne.

ParamètreValeursDéfaut
period7d 30d 90d month30d
GET/api/orders

Liste des commandes.

ParamètreDescription
qRecherche libre : n° de commande, e-mail, nom, ville
financialÉtat de paiement : PAID, PENDING, REFUNDED…
fulfillmentÉtat de préparation : FULFILLED, UNFULFILLED…
from · toAAAA-MM-JJ
sortdate_desc (défaut), date_asc, total_desc, total_asc, number_desc, number_asc
page · page_sizePagination, page_size jusqu'à 250
GET/api/orders/<id>

Une commande avec ses lignes d'articles, ses expéditions et ses remboursements.

GET/api/customers

Liste des clients.

ParamètreDescription
qRecherche libre
sortcreated_desc (défaut), created_asc, spent_desc, spent_asc, orders_desc, name_asc
page · page_sizePagination
GET/api/customers/<id>

Un client avec tout son historique de commandes.

GET/api/acquisition

Canaux, campagnes, codes promo, produits et sessions.

ParamètreValeursDéfaut
period7d 30d 90d month30d
dimlast_source_type, first_source_type, last_utm_source, last_utm_medium, last_utm_campaign, first_landing_pagelast_source_type

Shopify n'attribue pas toutes les commandes. Celles sans attribution apparaissent sous (sans données) — ce n'est pas une erreur, voir la section 5.

GET/api/sessions

Série quotidienne des sessions du marché France : sessions, visiteurs, pages vues, ajouts au panier, checkouts entamés, checkouts terminés, rebonds, durée moyenne.

GET/api/sync

État de la synchronisation : date de dernière mise à jour de chaque source. À interroger avant un export si la fraîcheur des données compte.

04Export CSV

Ajoutez format=csv à /api/orders ou /api/customers. Tous les filtres ci-dessus s'appliquent, et le résultat n'est pas paginé.

ParamètreValeurs
detail(vide) une ligne par commande · lines une ligne par article · attribution commande + canal, campagne et UTM
dialectexcel (défaut) : séparateur ;, virgule décimale, BOM, en-têtes traduits, heure de Paris · raw : CSV standard, séparateur ,, point décimal, en-têtes techniques, dates ISO UTC

Utilisez excel pour ouvrir directement dans Excel, raw pour alimenter un script ou un entrepôt de données.

Commandes d'un mois, une ligne par article
curl -H "Authorization: Bearer csn_xxxx" \
     "https://hts.crownsportnutrition.fr/api/orders?format=csv&detail=lines\
&from=2026-09-01&to=2026-09-30&dialect=raw" \
     -o commandes_09.csv

Limite : 50 000 lignes par export. Au-delà, découpez avec from et to.

Pour un export récurrent, planifiez cette commande de votre côté (cron). Les données sont rafraîchies plusieurs fois par jour ; /api/sync indique l'heure exacte de la dernière passe.

05Limites connues

À lire avant d'exploiter les données. Ces quatre points expliquent des champs vides ou à zéro qui sont exacts, et non des pannes.

Historique

L'attribution ne couvre pas les commandes reprises

Les commandes migrées depuis l'ancien site WooCommerce n'ont aucune donnée d'attribution : une reprise de base ne transporte pas l'origine de la session d'achat d'origine.

Un rapport « performance par source » calculé sur tout l'historique affichera donc une large majorité de (sans données). L'attribution n'est exploitable que sur les commandes nées dans Shopify.

Indisponible

Vues produit

Non disponibles — et pas à cause de cette API : Shopify lui-même ne les expose pas, ni dans son API, ni dans son back-office. Shopify a retiré sa page Product insights en 2024 et renvoie vers Google Analytics 4 pour ce besoin.

Le plus proche que nous fournissons est le trafic par page d'atterrissage, dont les pages produit, via /api/acquisition : cela couvre « par où les visiteurs entrent », pas « ce qu'ils consultent ensuite ».

Hors périmètre

Dépenses publicitaires, CAC, ROAS

Ces montants vivent dans Meta Ads et Google Ads, pas dans Shopify. Les brancher demanderait un projet distinct avec ses propres accès.

Alimenté

Remboursements et annulations

Les remboursements sont lus depuis l'API de commandes de Shopify, et non depuis une analytique de navigateur. Une valeur à zéro signifie donc qu'il n'y a pas eu de remboursement sur la période ; ce n'est pas une donnée manquante.

Les commandes annulées sont conservées et identifiables, mais exclues du chiffre d'affaires.

06Codes de réponse

200OK
400Paramètre invalide
401Jeton absent, invalide ou révoqué
404Ressource inexistante ou hors du marché France
429Trop de requêtes — espacez les appels