Med Fabrixas print-on-demand-lösning API kan vilken POD-plattform eller webbutik som helst skicka en beställning och spåra dess livscykel genom order.created och order.updated webhooks, och låta Fabrixa sköta tryck, packning och leverans som white-label – från ett enda exemplar och över hela EU. Du skapar köpupplevelsen; vi sköter den flexibla textilproduktionen bakom kulisserna. Inget minimibeställningsantal, inga startavgifter, inget Fabrixa-varumärke på paketet.
Det här inlägget är en översikt på lättförståeligt språk av Integration API (v2) för utvecklare som utvärderar Fabrixa som ett logistiklager. Om du istället vill bläddra igenom referensmaterialet finns den fullständiga API-dokumentation och steg för steg integrationsguide är redo när du är det.
Vad API är till för
Fabrixa är en plattform för reaktivt textiltryck: en enda kontrollpanel för försäljningskanaler, design, produktion och leverans. De flesta kunder ansluter via Shopify, WooCommerce eller Fabrixa Studio. Integrationen API är det fjärde alternativet – utvecklad för POD-plattformar och utvecklare som redan har en egen webbutik och vill ha programmatisk kontroll över orderhanteringen.
Du ringer API för att lägga in beställningar. Fabrixa tillverkar produkterna: reaktivt tryck på bomull och linne i Portugal och Spanien, sublimeringstryck på polyester i Nederländerna. Paketen skickas under ditt varumärke, med din returadress, och utan några Fabrixa-märkningar någonstans på förpackningen. Dina kunder får aldrig veta att vi finns, såvida du inte berättar det för dem.
Vad API gör
- Ping — en enkel kontroll för att bekräfta att dina inloggningsuppgifter och din anslutning fungerar innan du skickar något på riktigt.
- Produkter — läs igenom den katalog du håller på att sammanställa: kläder, hemtextilier och tyg per meter, med de basmodeller och varianter som finns tillgängliga för tryck.
- Beställningar — skapa en beställning och hämta dess status. Detta är kärnan i varje integration: rader, källor, kund- och leveransuppgifter matas in; en spårbar beställning returneras.
- Leveranser — följ produktionen och leveransen allteftersom varorna tillverkas och skickas, så att din plattform kan visa korrekt status för säljarna.
- Studio — bifoga en personlig design i Fabrixa Studio (vår inbäddningsbara produktkonfigurator med white label) till en beställning utifrån dess
cart_item_key, så det som köparen har designat är precis det som skrivs ut.
Autentisering och begränsningar av begärandetal
Integrationen API (v2) finns på bas-URL:en https://api.fabrixa.com/v2/integration. Varje förfrågan innehåller två rubriker:
| Rubrik | Syfte |
|---|---|
Auktorisering: Bärare |
Din API-token – identifierar och godkänner begäran. |
X-Application-Key: |
Din applikationsnyckel – den används tillsammans med token, så båda måste finnas. |
Begränsningen är 30 förfrågningar per minut. Det räcker gott och väl för beställningsdriven trafik, men det innebär att massoperationer bör genomföras i lugn takt istället för att köras i en tät loop. Hantera gränsen på ett smidigt sätt, dra ner takten när du når den och använd webhooks (se nedan) istället för polling.
Webhooks: reagera på status, istället för att kontinuerligt avfråga den
I stället för att hela tiden fråga “är det klart än?”, kan du prenumerera på webhooks och låta Fabrixa meddela dig när något ändras. Integrationen API skickar ut två händelser:
- order.created — aktiveras när en beställning tas emot för produktion. Använd den för att bekräfta mottagandet till säljaren och markera beställningen som pågående.
- order.updated — utlöses när ordern går igenom produktions- och leveransprocessen, inklusive spårning. Använd den för att hålla plattformens status synkroniserad utan att överskrida din begränsning.
Med två händelser och en gräns på 30 per minut når en välfungerande integration knappt gränsen: skicka ordern och reagera sedan på svaret.
Orderflödet, från början till slut
Oavsett vilken väg du väljer är formen densamma:
- Anslut — en webbutik (Shopify eller WooCommerce) eller API.
- Design — anpassa i Fabrixa Studio, eller skicka in en tryckfärdig PDF-fil.
- Skicka beställningen — via API, med produktrader, kund- och leveransadress.
- Vi tillverkar och levererar — Fabrixa sköter tryckning, förpackning och leverans som white-label-tjänst.
En kort kommentar om kvaliteten, eftersom det är anledningen till att säljare väljer reaktivfärgning: det reaktiva färgämnet bildar en kovalent bindning med cellulosan i bomullsfibrerna och fixeras permanent med hjälp av värme och ånga. Färgen blir en del av fibern – inget ytskikt, inga sprickor vid böjpunkter – så det känns som otryckt bomull och behåller vanligtvis färgen i över 600 tvättcykler. Som ett exempel på leveranstid tar det ungefär 6–9 arbetsdagar för kläder tillverkade i Portugal.
Varför plattformar bygger på Fabrixa
- MOQ 1 — från ett stycke till tiotusentals. Ingen minsta beställningsmängd, inga startavgifter, inga avtal.
- White-label som standard — kundens varumärke på varje paket, inte vårt.
- Kort leveranskedja inom EU — transporter inom Portugal, Spanien och Nederländerna, inte långdistansfrakt.
- Verkligt reaktivt tryck — GOTS-certifierad ekologisk bomull som standardmaterial, samt OEKO-TEX Standard 100 och Made in Green.
Vanliga frågor
Måste jag använda Fabrixa Studio för att kunna använda API?
Nej. Studio är valfritt. Du kan istället skicka en tryckklar PDF tillsammans med beställningen. Studio används endast när du vill att köparna ska kunna anpassa en produkt i din webbutik, och du kopplar den designen till beställningen genom att cart_item_key.
Hur autentiserar jag förfrågningar?
Skicka två rubriker vid varje anrop: Auktorisering: Bärare och X-Application-Key:. Båda krävs – om den ena saknas kommer ansökan att avslås.
Vad händer om jag når hastighetsbegränsningen?
API har en gräns på 30 förfrågningar per minut. Om du överskrider den gränsen bör du vänta en stund och försöka igen, istället för att överbelasta slutpunkten. För statusändringar ska du använda order.created och order.updated webhooks istället för polling – de håller dig uppdaterad utan att förbruka förfrågningar.
Är leveransen verkligen en white-label-lösning?
Ja. Paketen skickas under ditt varumärke med din returadress och utan Fabrixa-märkning som standard. Dina slutkunder ser aldrig oss.
Börja bygga
Det snabbaste sättet att ta sig in är att integrationsguide, med fullt stöd av API-dokumentation. Om du hellre vill se hur det hela hänger ihop först, så är plattformsöversikt går igenom olika steg: Studio, produktion och leverans. Och om du vill testa hur väl det passar just din plattform, prata med vårt team — vi går gärna igenom just ditt användningsfall.
