01
Bestillinger
POST /v2/integration/orders
Send inn en bestilling med rader, kilde-PDF-filer, kundeopplysninger og leveringsadresse. Returnerer Fabrixa-bestillings-ID. Valgfrie felt for fraktetikett og sporingsnummer.
API-dokumentasjon
Ett endpoint. Uendelig mange produkter.
Hver Fabrixa-SKU, hvert stoff, hver finish – adresserbar via ett dokumentert REST API. JSON inn, JSON ut. Webhooks for hver tilstandsovergang. Selvbetjente API-nøkler – opprett en salgskanal og begynn å bygge.
Hva du får
Utformet med utgangspunkt i hvordan produksjonen faktisk foregår.
En dokumentert REST API som gjenspeiler plattformen – bestillinger, fulfilment, Studio-tilpasning og webhooks. JSON inn, JSON ut. Bruk den sammen med dashbordet, eller styr alt programmatisk.
02
Fulfilment
GET /orders/{id}/fulfillments
Hent produksjonsstatus per varelinje: hvert trinn (trykk, fiksering, vask, sying) med statusene «ventende», «pågår», «ferdig» og «avvist». Eller abonner på webhooks for push-varsler.
03
Studio
iframe-innbygging
Integrer Fabrixa Studio i nettbutikken din. Kundene kan tilpasse produktene i sanntid, med postMessage-hendelser for «legg til i handlekurven» og «tilbake», samt en forhåndsvisnings-URL for miniatyrbilder i handlekurven.
04
Webhooks
order.created / order.updated
To emner: HMAC-SHA256-signerte payloader, fullstendig ordretekst, levering med 10 forsøk og back-off.
Hurtigstart
Legg inn en bestilling med én POST.
Autentisert forespørsel, validert datapakke, plass reservert i produksjonskøen. Bekreftelse mottas i løpet av millisekunder – kundens bestilling er nå i gang.
Fullstendig skjema, alle endpointer, feilkoder, rate limiter og integrasjonseksempler finnes i den tekniske dokumentasjonen.
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" } }
Integrasjonsprosess
Live på to uker. Ingen proxy, ingen middleware.
Direkte REST-integrasjon i plattformen din. Ingen SDK nødvendig, ingen proxy-server, ingen tredjeparts-kobling. Standard HTTP fra din systemstabel til vår.
01
Legitimasjon
Få et Application Access Token og en Application Key ved å opprette en salgskanal i dashbordet ditt. Begge deler er påkrevd ved hver forespørsel: «Bearer»-token i «Authorization», og Application Key i «X-Application-Key».
02
Katalog
Gå gjennom den interaktive Swagger-referansen for å finne variant-SKU-er for produktene du ønsker å selge, samt filter- og pagineringsmønstre.
03
Bestillinger
Ved kassen sender du en POST-forespørsel med rows, sources (PDF-URL-er), customer og shipping_address. Lagre den returnerte Fabrixa-bestillings-ID-en sammen med din egen bestillingsreferanse.
04
Webhooks
Opprett et offentlig POST-endpoint. Vi signerer hver enkelt payload med HMAC-SHA256 (x-webhook-signature), slik at du kan bekrefte ektheten før du behandler den.
05
Studio
Valgfritt: Sett inn Fabrixa Studio-iframe på produktsiden din. Kundene tilpasser produktet i sanntid og legger til sine tilpasninger i bestillingen ved hjelp av en POST-forespørsel.
Ressurser for utviklere
Alt det tekniske teamet ditt trenger.
Fullstendig API-referanse
Fullstendig dokumentasjon av endpointer, forespørsels- og svarskjemaer, feilkoder, rate limiter, autentisering, Studio-integrasjon og webhook-kontrakter – med et Swagger-grensesnitt i sanntid.
Åpne dokumentasjonen →Utvikle med tanke på en salgskanal
Opprett en egen salgskanal som du kan bygge videre på – send inn testbestillinger, sjekk at webhook-meldingene kommer frem, test spesielle tilfeller – og send deretter ekte trafikk til den aktive kanalen din. Nøklene dine er klare så snart du oppretter kanalen – uten at du trenger å sende inn en forespørsel.
Opprett din konto →Postman-samling
Forhåndskonfigurert samling av forespørsler med eksempler på payload og autentisering. Importer den inn i testarbeidsflyten din.
Få tak i samlingen →
Sikkerhet
Autentisering med to headere. Signerte webhooks. Rate limit.
Standardpraksis, ingen overraskelser. Hver forespørsel autentiseres med både et Bearer-token og en applikasjonsnøkkel. Hver webhook er HMAC-signert for verifisering, med forutsigbare rate limiter per applikasjon.
Tilgangstoken for applikasjonen
Bearer-token i Authorization-headeren. Identifiserer applikasjonen som sender forespørselen.
Applikasjonsnøkkel
Sendes i X-Application-Key-overskriften. Begge er obligatoriske i hver forespørsel — hvis en av dem mangler, returneres feilkode 401.
TLS-kryptering
api.fabrixa.com bruker utelukkende HTTPS. Forespørsler i klartekst avvises ved inngangen.
Webhook-signaturer
Hver webhook er signert med HMAC-SHA256, og signaturen sendes i x-webhook-signature-overskriften. Kontroller dette før du behandler dataene.
Ratebegrensninger
30 forespørsler per applikasjon per minutt. X-RateLimit-Limit og X-RateLimit-Remaining returneres i hvert svar.
Nye forsøk på webhook
Opptil 10 leveringsforsøk ved svar som ikke er av typen 2xx eller 3xx. Webhooken deaktiveres etter det 10. mislykkede forsøket.
Ofte stilte spørsmål
Integrasjonen API, besvart
Hvordan autentiserer jeg meg med Fabrixa og API?
Hver forespørsel må inneholde to overskrifter: et applikasjonstilgangstoken som sendes som et «Bearer»-token i «Authorization»-overskriften, og en applikasjonsnøkkel i «X-Application-Key». Begge genereres i det øyeblikket du oppretter en salgskanal i Fabrixa-dashbordet, og en forespørsel avvises med feilkode 401 hvis en av overskriftene mangler.
Kan jeg teste Fabrixa og API før jeg sender inn ekte ordrer?
Ja – opprett en egen salgskanal som du kan bygge videre på, send inn testbestillinger, kontroller at webhook-meldingene kommer frem og test ekstreme tilfeller, og send deretter ekte trafikk til den aktive kanalen din så snart den fungerer. Når du registrerer og oppretter denne kanalen, blir applikasjonstilgangstokenet og applikasjonsnøkkelen din umiddelbart tilgjengelige, uten at du trenger å foreta en separat forespørsel.
Er Fabrixa-integrasjonen API kryptert med HTTPS?
Ja — API bruker utelukkende HTTPS på api.fabrixa.com, og alle forespørsler i klartekst avvises ved inngangen. Hver forespørsel autentiseres også med både et Bearer-token og en applikasjonsnøkkel, og hver webhook-payload signeres med HMAC-SHA256 slik at den kan verifiseres før den behandles.
Hva returnerer et POST-anrop til /v2/integration/orders?
Et autentisert POST-forespørsel til /v2/integration/orders validerer payloaden, reserverer en plass i produksjonskøen og returnerer en bekreftelse med Fabrixa-ordre-ID-en i millisekunder, sammen med valgfrie felt for fraktetikett og sporingsinformasjon. Oppfyllelsen kan deretter spores per varelinje eller sendes til deg via webhooks.
Trenger jeg et SDK eller en proxy for å integrere med Fabrixa og API?
Nei — fabrixa-integrasjonen er en direkte REST-forbindelse via standard HTTP, uten krav om SDK, uten proxy-server og uten behov for tredjeparts-koblingsmoduler. Du kommuniserer direkte med fabrixa fra din egen stakk ved hjelp av JSON-forespørsler og -svar, med webhooks for endringer i status.
Begynn å bygge
Opprett en salgskanal og begynn å bygge opp i dag.
Registrer deg, opprett en salgskanal, så er API-påloggingsopplysningene dine klare med en gang. Trenger du hjelp? Våre løsningsingeniører svarer innen 24 timer – de fleste teamene er i drift innen to uker.