01Authentification
Deux en-têtes équivalents, au choix. Les jetons commencent par
csn_, sont nominatifs et révocables à tout moment.
Authorization: Bearer csn_xxxxxxxxxxxxxxxxxxxx X-API-Key: csn_xxxxxxxxxxxxxxxxxxxx
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
| Format | JSON (UTF-8), sauf format=csv |
| Dates | ISO-8601 en UTC. L'interface web les affiche en heure de Paris |
| Montants | Nombres, en euros |
| Pagination | page (1..n) et page_size (1..250) |
| Date de commande | Date 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.
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.
Indicateurs de la période, répartition et série quotidienne.
| Paramètre | Valeurs | Défaut |
|---|---|---|
period | 7d 30d 90d month | 30d |
Liste des commandes.
| Paramètre | Description |
|---|---|
q | Recherche libre : n° de commande, e-mail, nom, ville |
financial | État de paiement : PAID, PENDING, REFUNDED… |
fulfillment | État de préparation : FULFILLED, UNFULFILLED… |
from · to | AAAA-MM-JJ |
sort | date_desc (défaut), date_asc, total_desc, total_asc, number_desc, number_asc |
page · page_size | Pagination, page_size jusqu'à 250 |
Une commande avec ses lignes d'articles, ses expéditions et ses remboursements.
Liste des clients.
| Paramètre | Description |
|---|---|
q | Recherche libre |
sort | created_desc (défaut), created_asc, spent_desc, spent_asc, orders_desc, name_asc |
page · page_size | Pagination |
Un client avec tout son historique de commandes.
Canaux, campagnes, codes promo, produits et sessions.
| Paramètre | Valeurs | Défaut |
|---|---|---|
period | 7d 30d 90d month | 30d |
dim | last_source_type, first_source_type, last_utm_source, last_utm_medium, last_utm_campaign, first_landing_page | last_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.
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.
É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ètre | Valeurs |
|---|---|
detail | (vide) une ligne par commande · lines une ligne par article · attribution commande + canal, campagne et UTM |
dialect | excel (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.
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.
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.
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 ».
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.
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
| 200 | OK |
| 400 | Paramètre invalide |
| 401 | Jeton absent, invalide ou révoqué |
| 404 | Ressource inexistante ou hors du marché France |
| 429 | Trop de requêtes — espacez les appels |