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 fleksible 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 oppfyllingslag. Hvis du heller vil bla gjennom referansematerialet, finner du den fullstendige API-dokumentasjon og trinn for trinn integrasjonsveiledning er klare når du er klar.
Hva API brukes til
Fabrixa er en plattform for reaktiv tekstiltrykk: ett oversiktspanel for salgskanaler, design, produksjon og forsendelse. De fleste kunder kobler seg til via Shopify, WooCommerce eller Fabrixa Studio. Integrasjonen API er den fjerde løsningen – utviklet for POD-plattformer og utviklere som allerede har sin egen nettbutikk og ønsker programmatisk kontroll over ordrebehandlingen.
Du kontakter API 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 stoff per meter, 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.
- Oppfyllelser — 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 produktkonfigurator med hvitmerking) 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
Integrasjonen API (v2) ligger på basis-URL-en https://api.fabrixa.com/v2/integration. Hver forespørsel inneholder to overskrifter:
| Overskrift | 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. |
Ratebegrensningen 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 ordre blir satt i produksjon. Bruk den til å bekrefte mottakelsen overfor selgeren og merke ordren som under behandling.
- order.updated — utløses etter hvert som ordren går gjennom produksjon og utsendelse, inkludert sporing. Bruk den til å holde plattformens status oppdatert uten å overskride rategrensen din.
Med to hendelser og en grense på 30 per minutt kommer en velfungerende integrasjon knapt opp i grensen: send ordren, 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. Når det gjelder leveringstid, tar det for eksempel 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 taket for antall forespørsler?
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 ordrebehandlingen virkelig en «white-label»-løsning?
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å er oversikt over plattformen går 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.
