Med Fabrixa Print on Demand API kan enhver POD-plattform eller nettbutikk sende en bestilling og spore hele livssyklusen gjennom order.created og order.updated webhooks, og la Fabrixa trykke, pakke og sende varene som white-label-produkter – fra ett enkelt eksemplar og helt over hele EU. Du skaper kjøpsopplevelsen; vi står for den reaktive tekstilproduksjonen i bakgrunnen. Ingen minimumsbestilling, ingen oppstartsavgifter, ingen Fabrixa-merking på pakken.
Dette innlegget gir en oversikt på lettforståelig engelsk over Integration API (v2) for utviklere som vurderer å bruke Fabrixa som et fulfilment-lag. Hvis du heller vil bla gjennom referansematerialet, er fullstendig API-dokumentasjon og trinnvis integrasjonsveiledning klare når du er det.
Hva API brukes til
Fabrixa er en plattform for reaktivt tekstiltrykk: ett oversiktspanel for salgskanaler, design, produksjon og forsendelse. De fleste kunder kobler seg til via Shopify, WooCommerce eller Fabrixa Studio. Integrasjons-API-et er den fjerde løsningen – utviklet for POD-plattformer og utviklere som allerede har sin egen nettbutikk og ønsker programmatisk kontroll over fulfilment.
Du kaller API-et for å legge inn bestillinger. Fabrixa produserer dem: reaktivtrykk på bomull og lin i Portugal og Spania, sublimeringstrykk på polyester i Nederland. Pakkene sendes under ditt varemerke, med din returadresse, og uten noen Fabrixa-merker på pakken. Kundene dine får aldri vite at vi finnes, med mindre du forteller dem det.
Hva API gjør
- Ping — en enkel sjekk for å bekrefte at påloggingsopplysningene dine og tilkoblingen fungerer før du sender noe viktig.
- Produkter — se gjennom katalogen du bygger videre på: klær, boligtekstiler og metervare, med grunnmodeller og varianter som kan trykkes på.
- Bestillinger — opprett en ordre og hent statusen for den. Dette er kjernen i enhver integrasjon: rader, kilder, kunde- og leveringsopplysninger legges inn; en sporbart ordre kommer tilbake.
- Fulfilment — Følg med på produksjonen og forsendelsen etter hvert som varene blir produsert og sendt ut, slik at plattformen din kan vise selgerne nøyaktig status.
- Studio — legg ved et design som er tilpasset i Fabrixa Studio (vår innebyggbare white-label-produktkonfigurator) til en bestilling ved hjelp av dens
cart_item_key, så det kjøperen har designet, er akkurat det som blir trykket.
Autentisering og rate limiter
Integrasjons-API-et (v2) ligger på basis-URL-en https://api.fabrixa.com/v2/integration. Hver forespørsel inneholder to headere:
| Gardintopp | Formål |
|---|---|
Autorisering: Bærer |
API-tokenet ditt — identifiserer og godkjenner forespørselen. |
X-Application-Key: |
Applikasjonsnøkkelen din — brukes sammen med tokenet, så begge må være til stede. |
Rate limit er 30 forespørsler per minutt. Det er mer enn nok for trafikk som kommer fra bestillinger, men det betyr at masseoperasjoner bør gjennomføres i et jevnt tempo, i stedet for å kjøres i en tett sløyfe. Håndter grensen på en smidig måte, trekk deg tilbake når du når den, og bruk webhooks (se nedenfor) i stedet for polling.
Webhooks: Reager på status, ikke sjekk den kontinuerlig
I stedet for å spørre gjentatte ganger “er det ferdig ennå?”, kan du abonnere på webhooks og la Fabrixa gi deg beskjed når noe endres. Integrasjonen API sender ut to hendelser:
- order.created — utløses når en bestilling blir satt i produksjon. Bruk den til å bekrefte mottakelsen overfor selgeren og merke bestillingen som under behandling.
- order.updated — utløses etter hvert som bestillingen går gjennom produksjon og utsendelse, inkludert sporing. Bruk den til å holde plattformens status oppdatert uten å overskride din rate limit.
Med to hendelser og en grense på 30 per minutt kommer en velfungerende integrasjon knapt opp i grensen: send bestillingen, og reager deretter på svaret.
Ordreflyten, fra start til slutt
Uansett hvilken rute du velger, er formen den samme:
- Koble til — en nettbutikk (Shopify eller WooCommerce) eller API.
- Design — tilpass designet i Fabrixa Studio, eller send inn en trykkklar PDF-fil.
- Send bestillingen — via API, med produktrader, kunde- og leveringsadresse.
- Vi produserer og sender ut — Fabrixa står for trykking, pakking og frakt, som white-label tjeneste.
En kort kommentar om kvalitet, for det er grunnen til at selgere velger reaktivt fargestoff: Det reaktive fargestoffet danner en kovalent binding med cellulose i bomullsfiberen og festes permanent ved hjelp av varme og damp. Fargen blir en del av selve fiberen – ingen overflatelag, ingen sprekker ved bøyepunkter – så stoffet føles som ubehandlet bomull og beholder vanligvis fargen i over 600 vaskesykluser. Som eksempel på produksjonstid tar det omtrent 6–9 virkedager for klær produsert i Portugal.
Hvorfor plattformer bygger på Fabrixa
- MOQ 1 — fra ett stykke til titusenvis. Ingen minimumsbestilling, ingen oppstartsavgifter, ingen kontrakter.
- White-label som standard — kundens merke på hver pakke, ikke vårt.
- Kort forsyningskjede i EU — transport i Portugal, Spania og Nederland, ikke langdistansetransport.
- Ekte reaktivt trykk — GOTS-sertifisert økologisk bomull som standardmateriale, i tillegg til OEKO-TEX Standard 100 og Made in Green.
Ofte stilte spørsmål
Må jeg bruke Fabrixa Studio for å kunne bruke API?
Nei. Studio er valgfritt. Du kan i stedet sende en trykkklar PDF sammen med bestillingen. Studio kommer først til anvendelse når du ønsker at kundene skal kunne tilpasse et produkt i nettbutikken din, og du legger ved det designet til bestillingen ved å cart_item_key.
Hvordan autentiserer jeg forespørsler?
Send to overskrifter ved hvert anrop: Autorisering: Bærer og X-Application-Key:. Begge deler er påkrevd – hvis den ene mangler, vil søknaden bli avvist.
Hva skjer hvis jeg når rate limit?
API har en grense på 30 forespørsler per minutt. Hvis du overskrider denne grensen, bør du vente litt og prøve på nytt i stedet for å overbelaste endpointet. For statusendringer bør du bruke order.created og order.updated webhooks i stedet for polling — de holder deg oppdatert uten å bruke forespørsler.
Er fulfilment virkelig white-label?
Ja. Pakkene sendes under ditt varemerke med din returadresse, og det er som standard ingen Fabrixa-merking på dem. Sluttkundene dine ser oss aldri.
Begynn å bygge
Den raskeste måten å komme seg inn på er integrasjonsveiledning, med full støtte fra API-dokumentasjon. Hvis du heller vil se hvordan det hele henger sammen først, så går vår oversikt over plattformen gjennom kanalene, Studio, produksjon og utsendelse. Og hvis du ønsker å teste om det passer for plattformen din, Snakk med teamet vårt — vi hjelper deg gjerne med å gå gjennom bruksscenariet ditt.
