01
Ordini
POST /v2/integration/orders
Invia un ordine con righe, PDF di origine, dettagli del cliente e indirizzo di spedizione. Restituisce l'ID dell'ordine Fabrixa. Campi opzionali per l'etichetta di spedizione e il tracking.
Documentazione API
Un endpoint. Prodotti infiniti.
Ogni Fabrixa SKU, ogni tessuto, ogni finitura: tutti accessibili tramite un'unica REST API ben documentata. Input JSON, output JSON. Webhook per ogni transizione di stato. Chiavi API self-service: crei un canale di vendita e inizi a sviluppare.
Cosa riceve
Costruito su come funziona effettivamente la produzione.
Una REST API ben documentata che rispecchia la piattaforma: ordini, evasione, personalizzazione di Studio e webhook. Input JSON, output JSON. La usi insieme alla dashboard oppure gestisca tutto a livello di programmazione.
02
Fulfilment
GET /orders/{id}/fulfillments
Recuperi lo stato di produzione per ogni riga d'ordine: ogni fase (stampa, fissaggio, lavaggio, cucitura) con gli stati pending / in progress / done / rejected. Oppure sottoscriva i webhook per il push.
03
Studio
Incorporamento di un iframe
Integri Fabrixa Studio nel Suo negozio online. I clienti possono personalizzare i prodotti in tempo reale, grazie agli eventi postMessage per le operazioni di aggiunta al carrello e di ritorno alla pagina precedente, oltre a un URL di anteprima per le miniature del carrello.
04
Webhook
order.created / order.updated
Due topic: payload firmati con HMAC-SHA256, corpo dell'ordine completo, consegna con 10 tentativi e back-off.
Guida rapida
Effettuare un ordine in un unico POST.
Richiesta autenticata, payload convalidato, slot riservato nella coda di produzione. Conferma in pochi millisecondi: l'ordine del Suo cliente è ora in elaborazione.
Lo schema completo, tutti gli endpoint, i codici di errore, i rate limit e gli esempi di integrazione sono disponibili nella documentazione tecnica.
POST /v2/integration/orders
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "number": "ORD-2026-0142", "purchased_at": "2026-05-28 14:22:01", "rows": [ { "sku": "COF099191", "quantity": 1, "sources": [ { "type": "file", "url": "https://cdn.you.com/art/9812.pdf" } ] } ], "customer": { "first_name": "Maria", "last_name": "Silva", "email": "maria@example.com", "phone": "+351912345678" }, "shipping_address": { "address": "Rua do Carmo 42", "city": "Lisboa", "postal_code": "1200-094", "country_code": "PT", "country": "Portugal" } }
Flusso di integrazione
Operativi in due settimane. Nessun proxy, nessun middleware.
Integrazione REST diretta nella Sua piattaforma. Nessun SDK richiesto, nessun server proxy, nessun connettore di terze parti. HTTP standard dal Suo stack al nostro.
01
Credenziali
Ottenga un Application Access Token e un'Application Key creando un canale di vendita nella Sua dashboard. Entrambi sono necessari in ogni richiesta: il Bearer Token nell'intestazione Authorization e l'Application Key nell'intestazione X-Application-Key.
02
Catalogo
Consulti la documentazione Swagger live per individuare gli SKU delle varianti dei prodotti che desidera vendere, oltre ai modelli di filtro e paginazione.
03
Ordini
Al momento del checkout, invii una richiesta POST contenente rows, sources (URL dei PDF), customer e shipping_address. Associ l'ID ordine Fabrixa restituito al Suo riferimento d'ordine.
04
Webhook
Esporre un endpoint POST pubblico. Firmiamo ogni payload con HMAC-SHA256 (x-webhook-signature), in modo da poterne verificare l'autenticità prima dell'elaborazione.
05
Studio
Facoltativo: inserisci l'iframe di Fabrixa Studio nella pagina del Suo prodotto. I clienti personalizzano in tempo reale; allega le loro personalizzazioni all'ordine tramite POST.
Risorse per gli sviluppatori
Tutto ciò che serve al vostro team di ingegneri.
Riferimento completo API
Documentazione completa sugli endpoint, schemi di richiesta/risposta, codici di errore, rate limit, autenticazione, integrazione con Studio e contratti webhook — con un'interfaccia Swagger in tempo reale.
Aprire i documenti →Sviluppare in funzione di un canale di vendita
Crei un canale di vendita dedicato su cui lavorare — invii ordini di prova, verifichi la consegna dei webhook, verifichi i casi limite — quindi indirizzi il traffico reale verso il Suo canale attivo. Le Sue chiavi sono pronte nel momento stesso in cui crea il canale — non è necessario effettuare alcuna richiesta.
Crei il Suo account →Collezione Postman
Raccolta di richieste preconfigurate con payload di esempio e autenticazione. La importi nel Suo flusso di lavoro di test.
Ottenere la collezione →
Sicurezza
Autenticazione a due intestazioni. Webhook firmati. Rate limit prevedibili.
Pratiche standard, nessuna sorpresa. Ogni richiesta viene autenticata sia con un Bearer Token che con un'Application Key. Ogni webhook è firmato con HMAC a scopo di verifica, con rate limit prevedibili per ogni applicazione.
Application Access Token
Bearer Token nell'intestazione Authorization. Identifica l'applicazione chiamante.
Application Key
Inviata nell'intestazione X-Application-Key. Entrambi sono obbligatori in ogni richiesta: la mancanza di uno dei due comporta un codice di errore 401.
Crittografia TLS
Solo HTTPS su api.fabrixa.com. Le richieste in chiaro vengono rifiutate all'edge.
Firme dei webhook
Ogni webhook è firmato con HMAC-SHA256 e la firma viene inviata nell'intestazione x-webhook-signature. Verificare prima dell'elaborazione.
Rate limit
30 richieste al minuto per ogni applicazione. I parametri X-RateLimit-Limit e X-RateLimit-Remaining vengono restituiti in ogni risposta.
Retry dei webhook
Fino a 10 tentativi di consegna in caso di risposta diversa da 2xx o 3xx. Il webhook viene disattivato dopo il decimo tentativo fallito.
Inizia a costruire
Crea un canale di vendita e inizia a svilupparlo oggi stesso.
Si registri, crei un canale di vendita e le Sue credenziali API saranno pronte immediatamente. Ha bisogno di aiuto? I nostri Solutions Engineer rispondono entro 24 ore: la maggior parte dei team è operativa nel giro di due settimane.