Passa al contenuto
Italiano
Need to talk?
  • Non sono presenti suggerimenti perché il campo di ricerca è vuoto.

Importa i tuoi dati tramite la nostra API

1.1 Iniziare con l'integrazione API

Il tuo percorso

Il tuo technical account manager ti guiderà durante l’intero processo di integrazione API, fornendoti i token di autenticazione (bearer tokens) per l’ambiente sandbox (test) e produzione.

Questa figura ti accompagna durante tutto il progetto, dalla riunione di avvio fino alla messa in produzione, passando per il mapping dei dati, la configurazione delle connessioni (realizzata internamente dal tuo team o con il supporto di un integratore partner), e infine le fasi di test.

💡 Hai bisogno di aiuto? Contatta il tuo Technical Account Manager:

A seconda delle esigenze della tua azienda e della disponibilità IT, puoi scegliere tra tre livelli di supporto durante la fase di configurazione dell’API.

👉 Per maggiori informazioni, fissa un appuntamento con il vostro Technical Account Manager qui.

 

1.2 Requisiti tecnici per l’implementazione

Sequenza di importazione dei dati

È obbligatorio rispettare il seguente ordine durante la creazione dei dati:

Packaging (facoltativo) → Suppliers → Products → Components

Questo garantisce relazioni coerenti tra i dati ed evita errori di importazione.

Identificatori di sistema

È fondamentale comprendere come il sistema identifica i dati:

  • Prodotti: identificati univocamente dalla combinazione productRef + productCollectionRef + productColorCode

  • Componenti: identificati in modo univoco tramite componentRef (aggiungere altri campi se necessario per evitare duplicati tra categorie/stagioni)

Parametri richiesti per le chiamate API

Ogni chiamata API deve includere:

  • il tuo bearer token (chiave di sicurezza personale). Per ottenerlo, accedete alla piattaforma, andate su My Account, poi nella scheda Token API, oppure rivolgetevi al vostro referente IT,

  • un codice batch di importazione "importationBatch"(per identificare il blocco dati)

  • il tipo di progetto "ProjectType" (come definito nel tuo contratto Fairly Made, es. Standard o AGEC)

Non superare il limite di 150 richieste al secondo. Attendere 2–5 secondi tra la creazione di oggetti di tipo diverso.

Gestione degli ambienti

Lavorerai su due ambienti separati:

  • Sandbox: per i test, inizialmente vuoto, popolato con dati di test

  • Produzione: per i dati reali

Ogni ambiente ha un bearer token distinto.

 

1.3 Test e documentazione

Uso di Postman per i test

Puoi testare la tua integrazione API utilizzando Postman prima di passare alla produzione. Consulta la documentazione Postman per istruzioni dettagliate

Set di test

Per comprendere meglio la struttura dei dati richiesti per ciascun endpoint, puoi accedere a dataset di esempio tramite questo link. Ti aiuteranno a strutturare correttamente le tue chiamate API.

Hai due opzioni:

  • scaricare le collezioni Postman di test ed importarle nella tua app Postman

  • oppure consultare i nostri file JSON di esempio come riferimento

Accesso alla documentazione sull’API

 Puoi accedere alla documentazione tecnica completa qui. Include esempi di payload e scenari reali per ogni endpoint, per aiutarti a costruire correttamente le tue chiamate API.