Catalogue produits & API
Vos produits, vos avis, vos systèmes.
Gérez les fiches produits sur lesquelles portent vos avis, et récupérez ces avis par API REST pour les afficher où vous voulez : boutique, ERP, PIM ou tableau de bord interne.
Un catalogue qui se remplit tout seul
Vos produits arrivent à l'import de commandes ou à la réception d'une livraison. Vous ne saisissez rien : vous corrigez et complétez.
- Nom, prix et description modifiables en un clic
- Recherche instantanée sur tout le catalogue
- Liste paginée, adaptée aux catalogues volumineux
Le SKU, clé de vos avis produits
C'est la référence par laquelle vos widgets et vos appels API retrouvent les avis d'un produit. Une fois définie, elle est verrouillée.
- Aucun avis ne disparaît d'une fiche produit par accident
- Nom, prix et description restent librement modifiables
- Alignez le SKU sur celui de votre boutique dès la première saisie
Une clé, sous votre contrôle
Votre entreprise dispose d'une clé active, envoyée dans l'en-tête X-API-Key. Régénérez-la si vous la pensez compromise, révoquez-la quand vous n'en avez plus besoin.
- Affichée une seule fois : seule son empreinte est stockée
- Rotation et révocation en un clic depuis le tableau de bord
- Endpoint public sans clé pour l'affichage sur votre site
curl -H "X-API-Key: YOUR_API_KEY" \ -H "Accept: application/json" \ ".../companies/{id}/products/{ref}/reviews"
Trois lectures, un seul format
Un produit, plusieurs produits d'un coup, ou l'ensemble de votre catalogue : la réponse a toujours la même forme.
- Note moyenne, total d'avis et pagination dans chaque réponse
- Plusieurs références en une requête, séparées par des virgules
- Exemples cURL, PHP et JavaScript prêts à copier
{
"averageRating": 4.35,
"totalReviews": 23,
"page": 1,
"reviewsPerPage": 10,
"reviews": [ … ]
} Catalogue produits et API d'avis : relier vos avis à votre boutique
Un avis produit n'a de valeur que s'il s'affiche sur la bonne fiche. C'est le rôle du couple catalogue produits / API : le catalogue tient à jour la fiche de chaque produit — nom, prix, description, SKU — et l'API permet à vos propres systèmes d'aller chercher les avis rattachés à chaque référence.
Le catalogue ne se remplit pas à la main. Vos produits y entrent automatiquement lorsqu'une commande est importée ou qu'une livraison remonte par webhook depuis Yalidine ou Guepex. L'écran « Mes produits » sert ensuite à corriger un libellé, ajuster un prix, compléter une description, et retrouver n'importe quelle référence par recherche.
Le SKU occupe une place à part. C'est la clé qui relie un produit de votre boutique aux avis stockés chez Cachet Thika : vos widgets et vos appels API interrogent la plateforme par cette référence. Le modifier après coup ferait disparaître les avis de la fiche produit correspondante — c'est pourquoi il est verrouillé une fois défini, tandis que les autres champs restent librement modifiables. Alignez-le sur celui de votre boutique dès la première saisie.
Côté API, trois lectures couvrent l'essentiel des besoins : les avis d'un produit précis, ceux de plusieurs produits en une seule requête (références séparées par des virgules), ou l'ensemble des avis de votre entreprise. La réponse est toujours du JSON, avec la note moyenne, le nombre total d'avis, la pagination et la liste des avis. L'authentification passe par une clé envoyée dans l'en-tête X-API-Key.
Une clé n'est affichée qu'au moment de sa création : seule une empreinte cryptographique est conservée, ce qui la rend irrécupérable ensuite, y compris par nos équipes. Si vous la pensez compromise, la rotation en génère une nouvelle et invalide l'ancienne immédiatement. Et pour le simple affichage sur votre site, un endpoint public sans clé existe : c'est celui qu'utilisent les widgets Cachet Thika, et il n'expose aucun secret dans le navigateur.
Questions fréquentes
Qu'est-ce que le catalogue produits Cachet Thika ?
C'est l'écran « Mes produits » du tableau de bord, où vous gérez la fiche de chaque produit sur lequel vos clients laissent des avis : nom, prix, description et SKU. Les produits arrivent automatiquement lors de l'import de commandes ou de la réception d'une livraison par webhook ; le catalogue sert ensuite à les corriger, les compléter et les retrouver.
Pourquoi le SKU est-il verrouillé une fois défini ?
Parce que le SKU est la clé qui relie un produit de votre boutique aux avis affichés sur votre site. Vos widgets et vos appels API interrogent Cachet Thika par référence produit : changer un SKU déjà utilisé ferait disparaître les avis de la fiche produit correspondante. Le nom, le prix et la description restent modifiables à tout moment.
Comment récupérer mes avis produits par API ?
Cachet Thika expose des endpoints REST qui renvoient du JSON. Vous générez une clé depuis l'écran « Clés API », puis l'envoyez dans l'en-tête HTTP X-API-Key. Trois lectures sont possibles : les avis d'un produit précis, ceux de plusieurs produits en une requête (références séparées par des virgules), ou l'ensemble des avis de votre entreprise.
Que contient la réponse de l'API avis produits ?
Un objet JSON avec la note moyenne (averageRating), le nombre total d'avis (totalReviews), la pagination (page, reviewsPerPage) et la liste des avis. Chaque avis porte sa note, son contenu, sa date, le prénom de son auteur et la référence du produit concerné. Le format est directement exploitable pour alimenter une fiche produit, un moteur de recherche interne ou un tableau de bord maison.
Faut-il une clé API pour afficher des avis sur mon site ?
Non. Un endpoint public dédié renvoie les avis destinés à l'affichage, sans authentification — c'est celui qu'utilisent les widgets Cachet Thika. La clé API sert aux intégrations serveur à serveur : synchroniser vos avis dans votre ERP, votre PIM ou votre entrepôt de données, où l'appel ne doit pas être exposé au navigateur.
Les clés API sont-elles sécurisées ?
Une clé n'est affichée en clair qu'au moment de sa création : Cachet Thika n'en conserve qu'une empreinte cryptographique, ce qui rend impossible sa relecture ultérieure, y compris par nos équipes. Chaque entreprise dispose d'une clé active, que vous pouvez régénérer en un clic si vous la pensez compromise, ou révoquer pour couper tout accès.
Des exemples de code sont-ils fournis ?
Oui. L'écran « Clés API » génère, pour chaque endpoint, un exemple prêt à copier en cURL, PHP (Guzzle) et JavaScript (fetch), déjà renseigné avec l'identifiant de votre entreprise et la référence produit que vous saisissez. Vous collez, vous remplacez la clé, cela fonctionne.
Vos avis certifiés, dans vos propres systèmes.
Un catalogue produits qui se tient à jour tout seul, et une API REST pour aller chercher les avis là où vous en avez besoin.