L'API Fairly Made propose deux principaux endpoints GET pour consulter les données des produits analysées : l'un pour les informations publiques des showcases produit et l'autre pour les détails d'analyse complets. Ce guide explique les données renvoyées par chaque point d'accès et leurs différences.
Présentation des deux Endpoints
1. Get Study Showcase - Données de Communication Publique
🔗 Cet endpoint renvoie les informations affichées dans les showcases publiques de vos produits - les fiches produits standardisées accessibles via votre site web ou nos QR codes. Il s'agit des données destinées à la communication avec les clients finaux.
2. Get Study Details - Données d'Analyse Complètes
Cet endpoint (🔗 par critères d'unicité ou 🔗 par id) renvoie l'ensemble des données issues de l'analyse Fairly Made, incluant les 16 critères d'impact environnemental et les informations techniques détaillées qui ne sont pas affichées dans les showcases produit.
Endpoint Get Study Showcase
Objectif
Récupérer les informations qui apparaissent dans vos showcases produits, pour la communication orientée client.
Données Renvoyées
Champs Généraux au Produit
- Nom du produit
- Lien de sa photo (le cas échéant)
Emplacement de la donnée sur la showcase :
Détails de la Traçabilité & des Impacts Produit
- Informations de traçabilité composant par composant
- Impacts environnementaux clés (3 indicateurs parmi les 16 analysés)
- Détails du Coût Environnemental
Emplacement de la donnée sur la showcase :
Exemple d'affichage du Coût Environnemental (dans la version en langue française), avant le détail des impacts :
💡 Pour en savoir plus sur ce Coût et sur la méthodologie utilisée, veuillez vous référer à cet article.
Notes & Certificats Produit
- Notes Fairly Made (dans le cas où vous souhaitez les afficher)
- Certifications Produit
Emplacement de la donnée sur la showcase :
Données de Conformité à la Loi AGEC
Pour le Packaging:
- Description de chaque type d'emballage utilisé
- 5 allégations AGEC possibles spécifiques à l'emballage
Emplacement de la donnée sur la showcase :
Pour le Produit:
- Allégations AGEC (par exemple, bonus d'éco-modulation pour la fourniture de pièces détachées), 3 possibles :
Emplacement de la donnée sur la showcase :
Endpoint Get Study Details
Objectif
Récupérer les informations qui apparaissent dans vos showcases produits pour la communication orientée client.
Données Renvoyées
Champs Généraux au Produit
- Données générales du produit et identification
Détail des Composants
- Composition et traçabilité détaillée par composant (matière principale, doublure, etc.)
Résultats Complets de l'ACV
- Les 16 critères d'impact environnemental:
- Utilisation des ressources (minéraux/métaux, combustibles fossiles)
- Acidification
- Toxicité humaine (cancérigène/non cancérigène)
- Eutrophisation (eau douce/marine/terrestre)
- Écotoxicité (eau douce)
- Changement climatique
- Rayonnement ionisant
- Utilisation des terres
- Appauvrissement de la couche d'ozone
- Particules fines
- Formation d'ozone photochimique
- Consommation en eau
Notes Fairly Made
- Répartition détaillée des scores (notés sur 5)
Coût Environnemental
- Valeur du Coût Environnemental
- Répartition détaillée du coût
💡 Pour en savoir plus sur ce Coût et sur la méthodologie utilisée, veuillez vous référer à cet article.
Ressources numériques
- Lien vers les QR codes Fairly Made
Analyse Détaillée du Packaging
- Spécifications complètes de l'emballage
- 5 allégations AGEC possibles pour l'emballage
Allégation AGEC du Produit
- 3 allégations AGEC possibles spécifiques au produit
Disponibilité des Données
Les deux endpoints nécessitent que :
- Le produit ait été analysé par Fairly Made (statut « PUBLISHED » ou « COMPLETED »)
- Vous disposiez d'identifiants d'authentification API valides
🔗 Consultez un exemple de showcase produit ici.
Prochaines Étapes
Pour intégrer ces endpoints :
- Examinez les exemples de réponses JSON (ici)
- Identifiez les champs de données nécessaires pour votre cas d'usage
- Implémentez l'endpoint approprié dans votre application
- Testez avec des études de produits exemples
Pour les détails techniques d'implémentation, l'authentification API et les spécifications des différents endpoints, veuillez consulter la documentation de l'API Fairly Made.