Types de produits
Chariow prend en charge plusieurs types de produits :| Type | Description |
|---|---|
downloadable | Fichiers numériques que les clients peuvent télécharger après l’achat |
course | Cours en ligne avec chapitres et leçons structurés |
license | Licences logicielles avec gestion de l’activation et de la validation |
service | Services numériques, consultations ou travaux personnalisés |
bundle | Collection de plusieurs produits vendus ensemble à prix réduit |
Catégories de produits
Les produits sont organisés selon les catégories suivantes :| Catégorie | Valeur |
|---|---|
| Arts créatifs | creative_arts |
| Technologie | technology |
| Business et Finance | business_and_finance |
| Développement personnel | personal_development |
| Éducation et Apprentissage | education_and_learning |
| Divertissement | entertainment |
| Santé et Bien-être | health_and_wellness |
| Littérature et Édition | literature_and_publishing |
| Médias et Communication | media_and_communication |
| Divers | miscellaneous |
États des produits
Les produits peuvent être dans différents états :- Draft - Non visible pour les clients, encore en cours de modification
- Published - Disponible à l’achat sur votre boutique
- Archived - Plus disponible mais conservé dans les archives
L’API publique retourne uniquement les produits publiés. Les produits en brouillon et archivés ne sont pas accessibles via l’API.
Lister les produits
Récupérez tous les produits publiés de votre boutique avec filtrage optionnel :Paramètres de requête
| Paramètre | Type | Description |
|---|---|---|
per_page | integer | Nombre de produits par page (par défaut : 10, max : 100) |
cursor | string | Curseur de pagination de la réponse précédente |
search | string | Recherche par nom ou slug de produit |
category | string | Filtrer par catégorie (ex. technology, education_and_learning) |
type | string | Filtrer par type (ex. course, license, bundle) |
Pagination
L’API utilise une pagination basée sur les curseurs pour une récupération efficace des données :Exemple de réponse
Récupérer un produit unique
Récupérez les informations détaillées d’un produit spécifique par son ID public ou son slug :Détails du produit
Le point de terminaison pour un produit unique retourne des informations complètes incluant :- Tarification : Prix actuel, prix de base, prix de vente (si applicable) et pourcentage de réduction
- Images : Miniature et images de couverture
- Évaluations : Note moyenne et nombre d’avis
- Ventes : Nombre de ventes (si non masqué)
- Quantité : Informations sur le stock (si le produit a une quantité limitée)
- Offre groupée : Informations sur les économies pour les produits groupés
- Champs personnalisés : Champs de produit supplémentaires (lorsque chargés)
- SEO : Métadonnées SEO (lorsque chargées)
Types de tarification
Les produits peuvent avoir différents modèles de tarification :Paiement unique
Paiement unique
Un prix fixe que les clients paient une fois pour accéder au produit. C’est le type de tarification le plus courant.
Prix libre
Prix libre
Les clients choisissent le montant à payer, avec un prix minimum et un prix suggéré optionnels. Utile pour les dons, les logiciels à contribution ou la tarification déterminée par le client.
Gratuit
Gratuit
Produits disponibles gratuitement, souvent utilisés pour la génération de leads, les cadeaux ou les contenus d’exemple.
Prix promotionnel
Prix promotionnel
Les produits peuvent avoir des prix promotionnels temporaires avec une date d’expiration. Le
current_price reflète le prix actif.Offres groupées
Les offres groupées combinent plusieurs produits à un prix réduit. Lors de la récupération d’une offre groupée, vous recevrez des informations sur la valeur totale du groupe et les économies réalisées :Le
bundle.value indique la valeur totale si tous les produits étaient achetés séparément, tandis que pricing.current_price indique le prix réduit de l’offre groupée. Le bundle.savings montre combien les clients économisent en achetant l’offre groupée.Travailler avec les données de produit
Filtrer les produits
Vous pouvez combiner plusieurs filtres pour affiner vos requêtes de produits :Comprendre les évaluations
Les produits incluent des informations d’évaluation avec la note moyenne et le nombre total :- average : Note de 0 à 5
- count : Nombre total d’évaluations reçues
Quantité en stock
Pour les produits avec stock limité, le champquantity fournit des informations détaillées :
quantity: null.
Formatage des prix
Tous les objets de prix incluent trois champs pour un affichage flexible :- amount : Nombre décimal (ex.
99.00) - currency : Code de devise ISO (ex.
USD,EUR,GBP) - formatted : Chaîne prête à afficher (ex.
$99.00,£99.00,€99.00)
Cas d’utilisation courants
Créer un catalogue de produits
Afficher les produits en promotion
Trouver les produits populaires
Bonnes pratiques
Utiliser la pagination par curseur
Utiliser la pagination par curseur
Utilisez toujours la pagination basée sur les curseurs au lieu de récupérer tous les produits en une seule fois. Cela garantit une récupération efficace des données et évite les dépassements de délai.
Mettre en cache les données de produit
Mettre en cache les données de produit
Les données de produit ne changent pas fréquemment. Envisagez de mettre en cache les produits localement et de les actualiser périodiquement pour réduire les appels API.
Gérer les images manquantes
Gérer les images manquantes
Tous les produits n’ont pas d’images miniatures ou de couverture. Vérifiez toujours les valeurs
null avant d’afficher les images.Afficher les prix formatés
Afficher les prix formatés
Utilisez le champ
formatted des objets de prix pour l’affichage. Cela garantit un formatage correct des devises et des symboles.Vérifier l'expiration des promotions
Vérifier l'expiration des promotions
Lors de l’affichage des prix promotionnels, vérifiez que
on_sale_until est dans le futur pour éviter d’afficher des promotions expirées.