L’API Fairly Made offre due principali endpoint GET per consultare i dati dei prodotti analizzati: uno dedicato alle informazioni pubbliche dei showcase prodotto, e l’altro ai dettagli completi dell’analisi. Questa guida spiega i dati restituiti da ciascun punto di accesso e le differenze tra loro.
Presentazione dei due endpoints
1. Get Study Showcase - Dati di comunicazione pubblica
🔗 Questo endpoint restituisce le informazioni visualizzate negli showcase pubblici dei vostri prodotti — le schede prodotto standardizzate accessibili tramite il vostro sito web o i nostri codici QR.
Si tratta dei dati destinati alla comunicazione verso i clienti finali.
2. Get Study Details - Dati di analisi completa
Questo endpoint (🔗 per criteria di unicità or 🔗 per id) restituisce l’insieme dei dati derivanti dall’analisi Fairly Made, inclusi i 16 criteri di impatto ambientale e le informazioni tecniche dettagliate che non sono mostrate negli showcase prodotto.
Get Study Showcase endpoint
Obiettivo
Recuperare le informazioni che compaiono negli showcase dei vostri prodotti, destinate alla comunicazione orientata al cliente.
Dati restituiti
Campi generali del prodotto
- Nome del prodotto
- Picture all’immagine (se disponibile)
Posizione dei dati nello showcase:
Dettagli di tracciabilità e impatti del prodotto
- Informazioni di tracciabilità per ciascun componente
- Impatti ambientali principali (3 indicatori su 16 analizzati)
- Dettagli sul French environmental cost (Costo Ambientale)
Posizione dei dati nello showcase:
Esempio di visualizzazione del Costo Ambientale (nella versione in lingua francese), prima del dettaglio degli impatti:
💡 Per ulteriori informazioni su questo Costo e sulla metodologia utilizzata, consulta questo articolo.
Valutazioni & certificazioni del prodotto
- Valutazioni Fairly Made (se desiderate mostrarle)
- Certificazioni del prodotto
Posizione dei dati nello showcase:
Dati di confirmità alla legue AGEC
Per il Packaging:
-
Descrizione di ciascun tipo di imballaggio utilizzato
-
5 possibili dichiarazioni AGEC specifiche per il packaging
Posizione dei dati nello showcase:
Per il Prodotto :
- Dichiarazioni AGEC (ad esempio bonus di eco-modulazione per la disponibilità di pezzi di ricambio), fino a 3 possibili
Posizione dei dati nello showcase:
Get Study Details endpoint
Obiettivo
Recuperare le informazioni analitiche complete relative ai vostri prodotti.
Dati Restituiti
Campi generali del prodotto
- Dati generali e identificazione del prodotto
Dettaglio dei componenti
- Composizione e tracciabilità dettagliata per componente (materiale principale, fodera, ecc.)
Risultati completi dell'ACV - Metodologia francese
- I 16 criteri di impatto ambientale, secondo la metodologia francese :
-
-
Uso delle risorse (minerali/metalli, combustibili fossili)
-
Acidificazione
-
Tossicità umana (cancerogena/non cancerogena)
-
Eutrofizzazione (acque dolci/marine/terrestri)
-
Ecotossicità (acque dolci)
-
Cambiamento climatico
-
Radiazioni ionizzanti
-
Utilizzo del suolo
-
Deplezione dello strato di ozono
-
Particolato fine
-
Formazione di ozono fotochimico
-
Consumo d’acqua
-
- E le equivalenze per i campi cambiamento climatico, eutrofizzazione delle acque dolci e utilizzo delle risorse fossili.
Valutazioni Fairly Made
- Ripartizione dettagliata dei punteggi (su 5)
French Environmental Cost
-
Valore del Costo Ambientale
-
Dettaglio della sua ripartizione
-
Solo i valori preceduti da
publishedsono considerati ufficiali. -
I campi con il prefisso
frenchEnvironmentalCostrappresentano il nostro calcolo interno tramite Ecobalyse e non costituiscono una pubblicazione ufficiale. -
Il campo
isPublishedOnGovernmentPlatform(vero/falso) indica lo stato di pubblicazione di un punteggio sulla piattaforma governativa.
💡 Per ulteriori informazioni su questo Costo e sulla metodologia utilizzata, consulta questo articolo.
Risultati completi dell'ACV - Metodologia europea PEF
- PEF Single Score
- I 16 criteri di impatto ambientale, secondo la metodologia PEF :
- Uso delle risorse (minerali/metalli, combustibili fossili)
-
Acidificazione
-
Tossicità umana (cancerogena/non cancerogena)
-
Eutrofizzazione (acque dolci/marine/terrestri)
-
Ecotossicità (acque dolci)
-
Cambiamento climatico
-
Radiazioni ionizzanti
-
Utilizzo del suolo
-
Deplezione dello strato di ozono
-
Particolato fine
-
Formazione di ozono fotochimico
-
Consumo d’acqua
Risorse digitali
- Links ai codici QR Fairly Made
Analisi dettagliata del packaging
-
Specifiche complete dell’imballaggio
-
5 possibili dichiarazioni AGEC relative al packaging
Dichiarazioni AGEC del prodotto
- 3 possibili dichiarazioni AGEC specifiche del prodotto
Disponibilità dei dati
- L'endpoint Get Study Showcase è accessibile solo dopo che il prodotto è stato analizzato da Fairly Made e ha lo stato “PUBLISHED” o “COMPLETED”.
Entrambi gli endpoint richiedono che:
-
Voi disponiate di credenziali di autenticazione API valide
🔗 Consulta un esempio di showcase prodotto qui.
Prossimi passi
Per integrare questi endpoint:
-
Esamina gli esempi di risposte JSON (qui)
-
Identifica i campi dati necessari per il tuo caso d’uso
-
Implementa l’endpoint appropriato nella tua applicazione
-
Effettua test con studi di prodotto di esempio
Per i dettagli tecnici d’implementazione, l’autenticazione API e le specifiche dei vari endpoint, consulta la documentazione dell’API Fairly Made.