Conto
- GET /v1/account - verifica l'autenticazione, visualizza il livello
- GET /v1/account/usage - utilizzo del periodo corrente
- INSERIRE /v1/account/webhook - imposta URL webhook + eventi
SVILUPPATORI - COLLEZIONE DI POSTINI
Importare la collezione. Raggiungere l'API in cinque minuti.
Raccolta di Postman precostituita con esempi funzionanti per ogni endpoint REST Fabrixa. Inserite la vostra chiave API, fate clic sulle richieste e vedete le risposte effettive sandbox prima di scrivere una sola riga di codice di integrazione. Tracciato attraverso versioni: la raccolta si aggiorna quando lo fa l'API.
POSTMAN v10+ - SANDBOX + PRODUCTION ENVS - AGGIORNATO A OGNI RILASCIO API
COSA C'È NELLA COLLEZIONE
Ogni endpoint, con esempi di payload.
Organizzato in cartelle per risorsa: Account, Prodotti, Ordini, Webhooks, Editor SDK. Ogni richiesta viene fornita con un corpo di esempio funzionante, intestazioni preimpostate e un esempio di risposta di successo salvata. risposta di successo salvata, in modo da poter vedere in anteprima la forma della risposta prima di lanciare la richiesta.
Prodotti
- GET /v1/prodotti - elenco / paginazione / filtro
- GET /v1/products/:id - tutti i dettagli del prodotto
- GET /v1/products/:id/pricing - anteprima del livello del volume
Ordini
- POST /v1/ordini - creare (con chiave di idempotenza)
- GET /v1/ordini - elenco / paginazione
- GET /v1/ordini/:id - stato, tracciamento, ciclo di vita
- DEL /v1/ordini/:id - annulla prima del blocco della produzione
Webhook e SDK
- POST /v1/webhooks/test - evento di esempio per l'attivazione
- GET /v1/webhooks/events - elenca i tipi di evento
- GET /v1/sdk/keys - chiavi SDK pubbliche e segrete
IMPORTAZIONE IN 30 SECONDI
Postino → File → Importa → Link → incolla URL.
01
IMPORTARE LA COLLEZIONE
In Postman: File → Importazione → Collegamento. Incollare l'URL JSON dal pulsante di download qui sopra. Postman recupera e aggiunge la raccolta al proprio spazio di lavoro.
02
IMPORTARE L'AMBIENTE
Stesso flusso, ambiente URL: .../fabrixa-api.postman_environment.json. Imposta l'impalcatura delle variabili (URL di base, segnaposto chiave API).
03
IMPOSTARE LA CHIAVE API
Aprire l'ambiente importato, riempire FABRIXA_API_KEY con la chiave della sandbox. Passare all'env di produzione quando si è pronti a spedire.
VARIABILI D'AMBIENTE
Cosa c'è nel file env.
fabrixa.postman_environment.json
# Ambiente sandbox { "FABRIXA_BASE_URL": "https://sandbox.api.fabrixa.com/v1", "FABRIXA_API_KEY": "sk_sandbox_yourKeyHere", "FABRIXA_PUBLIC_KEY": "pk_sandbox_tuaChiavePubblica", "FABRIXA_WEBHOOK_URL": "https://your-tunnel.ngrok.io/webhook" } # Ambiente di produzione (file separato) { "FABRIXA_BASE_URL": "https://api.fabrixa.com/v1", "FABRIXA_API_KEY": "sk_live_yourKeyHere", "FABRIXA_PUBLIC_KEY": "pk_live_yourPublicKey", "FABRIXA_WEBHOOK_URL": "https://api.yourbrand.com/webhook" }
AUTENTICAZIONE PRECONFIGURATA
Token portatore applicato a livello di collezione.
La collezione Autorizzazione è configurata per ereditare la chiave API dall'ambiente attivo. Ogni richiesta all'interno della collezione la acquisisce automaticamente, senza configurare l'intestazione per ogni richiesta.
Per passare dalla sandbox alla produzione basta un clic sulla tendina dell'ambiente. Stessa collezione, chiavi diverse, URL di base diverso. Non è necessario modificare il codice.
ESEMPI DI LAVORO
Ogni richiesta viene inviata con un corpo di esempio e una risposta salvata.
La raccolta non è costituita solo da stub di URL: ogni richiesta è corredata da un corpo di esempio funzionante. di esempio, in modo da poter premere Invia e vedere i dati reali. Le risposte di esempio salvate sono sono visibili nel pannello Esempi per un riferimento offline.
CREARE ORDINE
POST /v1/ordini
Esempio di corpo per un ordine di 2 magliette con URL di grafica personalizzata, indirizzo del destinatario e chiave di idempotenza. Premere Invia per vedere una risposta 201 Created con order_id.
ELENCO PRODOTTI
GET /v1/prodotti
Query pre-filtrata per la categoria abbigliamento. Restituisce il catalogo pagina per pagina con taglie, GSM, tempi di consegna e livello di prezzo per SKU.
INNESCARE WEBHOOK
POST /v1/webhooks/test
Lancia manualmente un evento webhook di esempio all'URL registrato. Utile per il debug dei gestori di webhook senza effettuare un ordine reale.
CONTROLLO DELL'USO
GET /v1/account/usage
Utilizzo del periodo di fatturazione corrente, stato di avanzamento dei livelli, volume previsto per la fine del periodo. Utile per pianificare la capacità prima di un grande calo.
ANNULLARE L'ORDINE
DELETE /v1/ordini/:id
Annulla un ordine prima che si blocchi la produzione (in genere entro 24 ore dall'invio). Restituisce 409 se la produzione è già iniziata - la chiave di idempotenza gestisce i tentativi.
ANTEPRIMA DEI PREZZI
GET /v1/prodotti/:id/prezzi
Anteprima dei prezzi unitari tra i livelli di volume per un determinato SKU. Utile per mostrare ai clienti il risparmio unitario man mano che si aumenta la quantità dell'ordine.
VERSIONE
La collezione si aggiorna quando lo fa l'API.
Ogni release Fabrixa API invia una raccolta Postman aggiornata allo stesso URL. Importare nuovamente per raccogliere i nuovi endpoint e i payload di esempio - le richieste esistenti nella versione salvata rimangono funzionanti fino a quando l'endpoint non viene effettivamente deprecato.
01
URL STABILE
L'URL JSON della raccolta è permanente. La reimportazione richiama l'ultima versione. L'URL non cambia mai tra le versioni API.
02
RIFERIMENTO AL CHANGELOG
Vedi Registro delle modifiche per le note sulla versione API: cosa è stato spostato, cosa è stato aggiunto, cosa è stato deprecato.
03
POLITICA DI DEPREZZAMENTO
Gli endpoint hanno una finestra di deprezzamento di 12 mesi. La raccolta segnala le richieste deprecate nella descrizione, in modo che sia difficile perderle prima che si rompano.
SCARICARE E INIZIARE
Prendete la collezione. Lanciate la vostra prima richiesta.
URL di importazione: https://www.fabrixa.com/wp-content/themes/brighthub-fabrixa/assets/downloads/fabrixa-api.postman_collection.json