Types de produits
Chariow prend en charge plusieurs types de produits :Un créateur peut changer le type d’un produit qui n’a jamais été vendu. Ne considérez pas
type comme définitif si vous mettez les produits en cache.Catégories de produits
Les produits sont organisés selon les catégories suivantes :États des produits
Les produits peuvent être dans différents états :- Brouillon (
draft) : non visible pour les clients, encore en cours de modification - Publié (
published) : disponible à l’achat sur votre boutique - Suspendu (
suspended) : suspendu et indisponible à l’achat
L’API publique retourne vos produits quel que soit leur statut, brouillons compris. Vérifiez
status et n’affichez aux acheteurs que les produits dont le statut est published.Lister les produits
Récupérez les produits de votre boutique, du plus récent au plus ancien, avec filtrage optionnel :Paramètres de requête
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 effectif, prix de vente (si applicable), prix minimum, prix suggéré et pourcentage de réduction (
price_off) - Images : Miniature et images de couverture via
pictures - Catégorie : Catégorie du produit avec valeur et libellé
- Tarification par variante : Indique si le produit a une tarification par variante (
has_variant_pricing) - Prix de suivi publicitaire : Le prix actuel converti en USD via
pricing.tracking, pour les outils de suivi publicitaire comme le Meta Pixel - Évaluations : Nombre d’évaluations et part d’évaluations positives via
rating - Ventes : Nombre exact de ventes via
sales_count, ounulllorsque le produit le masque (les nouveaux produits le masquent par défaut) - Quantité : Informations exactes sur le stock (si le produit a une quantité limitée)
- Paramètres : Paramètres du produit tels que
is_shipping_address_required - Expiration de la promotion : Date et heure
on_sale_untilpour la tarification promotionnelle temporaire - Texte CTA personnalisé : Texte d’appel à l’action personnalisé via
custom_cta_text - Offre groupée : Informations sur les économies pour les produits groupés
- Coaching : Durée, format, fuseau horaire et pause entre les sessions pour les produits de coaching via
coaching - Description :
descriptionest du HTML, nettoyé par Chariow pour retirer le balisage dangereux
fields, seo et store sont présentes mais toujours null dans l’API publique.
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 acheteurs évaluent un produit par un pouce levé ou baissé. Les produits indiquent le nombre d’évaluations et la part d’évaluations positives :- total_ratings : Nombre d’évaluations reçues, avec ses versions formatée et abrégée
- thumbs_up_count : Nombre d’évaluations positives
- thumbs_up_percentage : Part d’évaluations positives, sous forme de chaîne (ex.
96%)
Quantité en stock
Pour les produits avec stock limité, le champquantity fournit le stock exact du produit (les pourcentages sont des nombres entiers) :
quantity: null.
Formatage des prix
Tous les objets de prix incluent quatre champs pour un affichage flexible :- value : Valeur numérique du montant (ex.
99pour $99.00) - formatted : Chaîne prête à afficher (ex.
$99.00,£99.00,€99.00) - short : Chaîne abrégée lisible avec
forHumans(ex.99,5K,1.25M) - currency : Code de devise ISO (ex.
USD,EUR,GBP)
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.Prochaines étapes
Lister les produits
Consultez la référence API pour lister les produits
Récupérer un produit
Consultez la référence API pour récupérer un produit
Guide de paiement
Apprenez à créer des sessions de paiement
Authentification
Apprenez comment fonctionne l’authentification API