Vai al contenuto principale

Documentazione API

Documentazione Fabrixa REST API - creazione di ordini, webhook, adempimenti in white label
DOCUMENTAZIONE API

Un punto di partenza. Prodotti infiniti.

Ogni Fabrixa SKU, ogni tessuto, ogni finitura - indirizzabile attraverso un unico REST documentato API. JSON in entrata, JSON in uscita. Webhook per ogni transizione di stato. Chiave Sandbox rilasciata il giorno stesso del contratto.

REST - JSON - WEBHOOKS - OPENAPI 3.1 - SANDBOX PRONTO

COSA OTTIENE

Infrastruttura di produzione come codice.

Non un cruscotto con un pulsante. Un REST API documentato che i vostri sviluppatori si integrano una sola volta e la vostra piattaforma scala senza interventi manuali.

01
CATALOGO
GET /catalogo

Cercate ogni SKU, tessuto, dimensione, finitura nel nostro sistema. Filtrare per categoria, materiale di base, certificazione o paese di produzione.

02
ORDINI
POST /ordini

Invia un ordine con grafica, SKU, indirizzo di spedizione e configurazione opzionale white-label. Restituisce l'ID dell'ordine e la data di spedizione prevista.

03
STATO
GET /ordini/{id}

Prelevate lo stato attuale in qualsiasi momento: in coda, in stampa, in cucitura, in CQ, imballato, spedito. Oppure sottoscrivete i webhook per un push in tempo reale.

04
LIBRI WEB
POST del vostro endpoint

Inviamo eventi al vostro URL su ogni transizione di stato. Ciclo di vita dell'ordine, invio, eccezioni, ritorni. Carichi utili firmati.

INIZIO RAPIDO

Effettuare un ordine in un unico POST.

Richiesta autenticata, payload convalidato, slot riservato nella coda di produzione. coda. Conferma in millisecondi. L'ordine del cliente è ora in movimento.

Lo schema completo, tutti gli endpoint, i codici di errore, i limiti di velocità e gli esempi di integrazione sono riportati nella documentazione tecnica. sono presenti nei documenti tecnici.

Riferimento completo API →
POST /v1/ordini
// POST https://api.fabrixa.com/v1/orders
// Autorizzazione: Bearer YOUR_API_KEY
{
  "sku": "abbigliamento.tee.unisex.bianco.m",
  "opere d'arte": "https://cdn.you.com/art/9812.png",
  "quantità": 1,
  "cliente_rif": "ordine-1042",
  "spedire a": {
    "nome":    "Maria Silva",
    "strada":  "Rua do Carmo 42",
    "città":    "Lisboa",
    "codice postale":"1200-094",
    "paese": "PT"
  },
  "etichetta_bianca": {
    "etichetta_collo":  "brand-a",
    "hangtag":     "marchio-riciclato",
    "imballaggio":   "brand-a-mailer"
  },
  "webhook": "https://you.com/hooks/fabrixa"
}
FLUSSO DI INTEGRAZIONE

In diretta tra due settimane. Nessun proxy, nessun middleware.

Integrazione diretta REST nella vostra piattaforma. Nessun SDK richiesto, nessun server proxy, nessun connettore di terze parti. HTTP standard dal vostro stack al nostro.

01
SCATOLA DI SABBIA
Ottenere le credenziali del test

Chiave Sandbox API rilasciata il giorno stesso del contratto. L'ambiente di prova è funzionalmente identico alla produzione.

02
CATALOGO
Mappatura dei prodotti

Sincronizzate il nostro catalogo SKU con il vostro negozio. Abbinate le SKU del vostro marchio alle nostre SKU di base.

03
ORDINE
Cablare il flusso degli ordini

Al momento del checkout, inviare un POST a /ordini. Convalidare la risposta. Memorizzare il nostro ID ordine rispetto all'ordine del cliente.

04
LIBRI WEB
Iscriviti agli eventi

Implementare un endpoint per ricevere aggiornamenti sullo stato. Noi firmiamo i payload; voi verificate le firme.

05
VAI IN DIRETTA
Passaggio alla produzione

Premete il tasto API. Gli ordini reali fluiscono. I clienti reali ricevono il prodotto. Monitoraggio tramite dashboard o flusso di webhook.

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, limiti di velocità, autenticazione. Le specifiche di OpenAPI 3.1 sono disponibili per il download.

Aprire i documenti →

Ambiente sandbox

Funzionalmente identico alla produzione. Invia ordini di prova, verifica la consegna di webhook, convalida di casi limite. Rilasciato con chiave API.

Richiedi l'accesso →

Collezione Postman

Raccolta di richieste preconfigurate con payload e autenticazione di esempio. Importazione nel flusso di lavoro di test.

Ottenere la collezione →
SICUREZZA

Autenticazione del portatore, webhook firmati, velocità limitata.

Pratiche standard, nessuna sorpresa. Ogni richiesta è autenticata. Ogni webhook firmato. I limiti tariffari si adattano al livello del vostro account.

Autenticazione del portatore
Ogni richiesta include l'intestazione Authorization: Bearer YOUR_API_KEY.
TLS 1.3
Tutto il traffico API è criptato. HTTPS applicato.
Firme dei webhook
Ogni webhook è firmato con HMAC-SHA256. Verificare prima dell'elaborazione.
Limiti tariffari
Livello di campionamento: 60 req/min. Produzione: 600 richieste/min. Scala: personalizzata.
Rotazione dei tasti API
Rotazione delle chiavi tramite dashboard. Chiavi Sandbox e di produzione separate.
Richiesta di idempotenza
POST /ordini supporta l'intestazione Idempotency-Key. Riproduzione sicura.
Richiedete una chiave Fabrixa sandbox API - emissione in giornata, parità di produzione completa
INIZIARE A COSTRUIRE

La chiave Sandbox viene rilasciata il giorno stesso del contratto.

Comunicateci il vostro stack, la vostra piattaforma, la vostra tempistica. Progettiamo il percorso di integrazione e la quotiamo entro 24 ore. La maggior parte dei team è operativa in 2 settimane.

Carrello (0 articoli)

Crea il tuo account