Guida pratica: la tabella di marcia per implementare l’API Fairly Made®
Sviluppo dell'integrazione API: fasi e spiegazioni
La nostra roadmap tipo
Ecco la roadmap tipo per implementare l'API in 4 mesi, suddivisi equamente tra Preparazione e Test. Questa durata può variare a seconda delle risorse disponibili nella tua azienda. Puoi completare qui la diagnostica di dati Fairly Made per identificare le tue esigenze.

Di solito pianifichiamo 2 mesi di preparazione, che consistono in:
- Presentazione del processo e revisione della documentazione API
- Data Mapping & Gap Analysis
- Transcodifica
Seguono uno o due mesi di sviluppo della connessione API, e infine almeno un mese di test:
- Definizione dell’approccio ai test
- Preparazione dei sistemi e delle applicazioni
- Test unitari
- Test di sistema
E infine andiamo live!
Una matrice RACI, che chiarisce ruoli e responsabilità, insieme a una roadmap più dettagliata, può essere fornita per maggiori dettagli.
Revisione della documentazione API
Questa documentazione è stata concepita con l’obiettivo di permetterti di gestire in piena autonomia gli import e il recupero dei dati.
Data mapping e transcodifica
La transcodifica è il processo di conversione o adattamento di un sistema (giuridico, linguistico o tecnico) in un'altra forma, mantenendone il significato.
La fase di Data Mapping consiste nel verificare che si disponga delle informazioni necessarie per realizzare uno studio Fairly Made: dati sui fornitori, sui componenti, sui prodotti e, eventualmente, sugli imballaggi (generalmente nel sistema PLM e/o ERP).
Successivamente, identifichiamo le informazioni mancanti, dove trovarle, come trasformare le tue informazioni affinché rispettino le regole del nostro modello di dati, ecc.
La fase di transcodifica fa coincidere le tassonomie, le nomenclature con quelle previste dal nostro Modello di dati.
Se hai già raccolto i vostri dati con il metodo tradizionale (con il nostro foglio di calcolo Brand Data Collection BDC .csv) con uno dei nostri Analisti, gran parte di questo lavoro è già stato fatto.
Le regole per il formato dei dati sono rigorosamente le stesse per il nostro folglio di calcolo e API.
Ambienti di test e tipi di richieste
Abbiamo 2 ambienti separati per utilizzare l’API, con Bearer Tokens separati:
- Sandbox è usato per i test e non costituisce una replica della produzione. Solo i test che avete creato lo popoleranno.
- Production è dove invierai e otterrai i tuoi dati reali.
Per ogni ambiente, puoi accedere ai tuoi dati tramite app.sandbox e/o app.fairlymade.
Abbiamo solo 2 tipi di richiesta: POST e GET :
- Le richieste POST sono utilizzate per inserire dati che possono provenire dal tuo ERP/PLM/PIM/Data Hub.
- Le richieste GET sono utilizzate per estrarre dati, i risultati dei nostri studi al tuo ERP/PLM/PIM/Data Hub.

Qualsiasi modifica del prodotto richiede aggiustamenti della catena di approvvigionamento, il che modifica fondamentalmente l'analisi. Questo influirebbe sulla tracciabilità, sulle valutazioni ambientali e sulla distribuzione degli impatti, aumentando il carico di lavoro degli analisti e potenzialmente ritardando le tempistiche.
Dalla fase di test alla produzione
Di solito selezioniamo alcuni prodotti di test da utilizzare nel nostro ambiente sandbox, perché crediamo nell’apprendimento pratico; se necessario, possiamo fornire un set esaustivo di prodotti di test in modo che non dobbiate affrontare la difficoltà di anticipare ogni singolo caso.
È ora il momento per il tuo team (o quello del tuo integratore) di sviluppare effettivamente questa connessione, impostare le routine, memorizzare i risultati, ecc.
I dettagli sui dati che devono essere inviati e come sono disponibili qui. Per quanto riguarda la documentazione API, troverai maggiori dettagli qui.
Dopo i test unitari e la validazione, saremo pronti per il tuo primo import di raccolta tramite API!
Siamo ovviamente disponibili durante quel periodo per aiutare i tuoi sviluppatori se necessario.
Se hai altre domande, suggerimenti o necessità di chiarimenti, invia un'e-mail a guillaume.babule@fairlymade.com o clotilde.bazin@fairlymade.com. Potete anche fissare un appuntamento con noi direttamente tramite questo link.