01
Importa la collezione
In Postman: File → Import → Link. Incolla l'URL JSON dal pulsante di download qui sopra. Postman aggiunge la raccolta — con le relative variabili — al Suo spazio di lavoro.
Sviluppatori · Collezione Postman
Importi la collection. Cinque minuti e ci siete.
Una collezione Postman preconfigurata con esempi pratici per l'API di integrazione Fabrixa. Inserisca le Sue credenziali, esegua le richieste e osservi le risposte reali dell'API prima ancora di scrivere una sola riga di codice di integrazione. Aggiornata a ogni release: la collezione si aggiorna ogni volta che si aggiorna l'API.
Cosa comprende la collezione
Ogni endpoint, con esempi di payload.
Organizzati in cartelle in base alla risorsa. Ogni richiesta viene fornita con un corpo di esempio già compilato, le due intestazioni di autenticazione preimpostate e una risposta di esempio salvata, in modo da poter visualizzare in anteprima il formato della risposta prima di inviare la richiesta.
Autenticazione e prodotti
- GET /ping — verifica delle credenziali
- GET /prodotti — elenco e impaginazione (SKU + variant_id)
- Schemi a campo completo nella documentazione di riferimento di Swagger
Ordini
- POST /orders — crea un ordine
- GET /orders/{id}/fulfillments — monitoraggio della produzione
Studio e webhook
- GET /v2/studio/customizations/{key}/preview
- Payload del webhook + verifica HMAC (esempio)
Importa in 30 secondi
File → Import → Link → incolli l'URL.
02
Apra la scheda "Variables"
La collezione viene fornita con le proprie variabili — base_url è precompilato; access_token e application_key sono segnaposto. Non è necessario alcun file di configurazione separato.
03
Incolli le Sue chiavi
Inserisca l'Application Access Token e l'Application Key relativi a un canale di vendita nella Sua dashboard, clicchi su "Save" e ogni richiesta verrà autenticata.
Variabili d'ambiente
Cosa c'è nel file env.
Un URL di base, due credenziali, integrati nella raccolta. Configuri il sistema per un canale di vendita, poi incolli le chiavi del Suo canale attivo al momento della pubblicazione: stessa raccolta, stesse richieste.
Variabili della collezione
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Autenticazione preconfigurata
Entrambe le intestazioni di autenticazione, preimpostate in ogni richiesta.
Ogni richiesta comporta Authorization: Bearer {{access_token}} e X-Application-Key: {{application_key}}, ricavate dalle variabili della collezione — senza bisogno di configurare le intestazioni per ogni singola richiesta. Per passare da un canale di vendita all'altro basta modificare quelle due variabili: stessa collezione, chiavi diverse.
Esempi pratici
Ogni richiesta viene inviata con un corpo di esempio e una risposta salvata.
La collezione non contiene solo URL di prova: ogni richiesta è accompagnata da un corpo di esempio completo, così può cliccare su "Send" e visualizzare dati reali. Le risposte di esempio salvate sono disponibili nel pannello "Examples" per poterle consultare anche offline.
Verifica autenticazione
Verifica innanzitutto che l'Application Access Token e l'Application Key siano validi. Restituisce il codice 200 in caso di esito positivo, 401 se manca un'intestazione.
Elenca i prodotti
Richiesta di catalogo paginato. Restituisce i prodotti pagina per pagina nell'envelope links / meta / data, con SKU e ID della variante per ogni articolo.
Crea un ordine
Esempio di corpo dell'ordine per una t-shirt (1 pezzo) con file PDF di origine, dati del cliente e indirizzo di spedizione. Clicchi su "Send" per visualizzare l'ordine creato con il relativo ID Fabrixa.
Monitoraggio della produzione
Estrae le fasi di produzione per singolo articolo (stampa, fissaggio, lavaggio, cucitura) con gli stati “pending”, “in progress”, “done” e “rejected” relativi a un ordine effettuato.
Anteprima di Studio
Restituisce l'immagine di anteprima renderizzata di una personalizzazione di Studio salvata: è possibile inserirla direttamente come miniatura nel carrello.
Verifica della firma
Un esempio pratico di ricalcolo della firma HMAC-SHA256 e di confronto con la firma x-webhook-signature prima dell'elaborazione.
Gestione delle versioni
La collezione si aggiorna quando lo fa l'API.
Ogni release dell'API include una collezione aggiornata allo stesso URL. Effettui una nuova importazione per acquisire i nuovi endpoint e i payload di esempio: le richieste esistenti nella versione salvata continueranno a funzionare fino a quando l'endpoint in questione non verrà effettivamente deprecato.
URL stabile
L'URL del JSON della collezione è permanente. Reimportandolo si scarica l'ultima versione: l'URL non cambia mai tra una release e l'altra.
Riferimento al changelog
Vedi il changelog per le note sulla versione API: cosa è stato spostato, cosa è stato aggiunto, cosa è stato deprecato.
Politica di deprecazione
Agli endpoint viene concessa una finestra di deprecazione di 12 mesi. La collezione contrassegna le richieste deprecate nella descrizione, in modo che siano difficili da trascurare prima che si verifichino problemi.
Scarica e avvia
Prendete la collezione. Lanciate la vostra prima richiesta.
Importi la collezione, inserisca le credenziali del Suo canale di vendita e invii la Sua prima richiesta in pochi minuti: non serve alcun codice di integrazione per iniziare a esplorare la piattaforma.