Det finns två sätt att skicka beställningar till Fabrixa: koppla ihop den butik du redan driver – Shopify eller WooCommerce – utan att behöva skriva kod, eller bygga direkt i API-integrationen. Den här guiden täcker båda alternativen: koppla ihop en försäljningskanal på några minuter, eller gå från auktorisering till leverans på femton minuter.
De flesta butiker använder aldrig API. Lägg till Fabrixa som försäljningskanal så skickas beställningarna från din butik direkt vidare till produktionen – produkterna synkroniseras, statusuppdateringar skickas tillbaka, och du behöver varken skriva eller underhålla någon kod. API-vägen längre ner är avsedd för anpassade butiksgränssnitt och POD-plattformar.
Öppna följande i din instrumentpanel: Create channel och välj vilken typ av integration du vill använda. Varje kanal har sina egna produkter, importerade beställningar och importregler – du kan ansluta så många kanaler som du vill.
Det finns inga nycklar att kopiera. Godkänn Fabrixa från din Shopify-admin så är anslutningen igång.
Create channel, välj Shopify.En WordPress-butik ansluts med ett REST-nyckelpar för läsning och skrivning – som genereras i WooCommerce och klistras in i Fabrixa en gång.
Settings → Advanced → REST API → Add key med Läs/Skriv behörigheter.ck_ nyckeln, cs_ hemligheten och din butiksdomän i Fabrixa.Säljer du skräddarsydda produkter? Fabrixa Studio — designredigeraren för white label — finns även tillgänglig i Shopify- och WooCommerce-butiker, så att dina kunder kan anpassa produkterna under ditt varumärke. Se Fabrixa Studio →
Anslutna butiker visas bredvid dina API- och partnerkanaler i vyn ”Kanaler” – synkroniserade produkter, mottagna beställningar, den senast importerade referensen och intäkter per kanal. Ändra status för en kanal från ”utkast” till ”live” när du är redo; inget nedströms förändras.
Ska du bygga en anpassad webbutik eller hellre din egen POD-plattform? Resten av den här guiden handlar om API-metoden – från inloggning till leverans i fyra steg.
Det finns tre saker som tar dig från noll till en aktiv beställning. Alla dessa utfärdas via din Fabrixa-kontrollpanel eller av din lösningsingenjör.
Ett åtkomsttoken för applikationen och en applikationsnyckel. Båda krävs vid varje förfrågan – tokenet i Authorization-rubriken och nyckeln i X-Application-Key. Skapa en försäljningskanal i din kontrollpanel för att generera dem direkt – ingen förfrågan behövs.
En HTTPS-ändpunkt som är tillgänglig för allmänheten och som tar emot JSON-POST-förfrågningar. Localhost fungerar under utveckling via en tunnel. Du verifierar HMAC-SHA256-signaturen för varje datapaket innan du bearbetar det.
Din bildfil – PDF, TIFF, JPG eller PNG – måste vara tillgänglig via HTTPS utan inloggning. RGB-färg, upp till 50 MB och 15 000 px per sida. Flersidiga PDF-filer består av en sida per lager. Vi hämtar filen och skapar de korrekta utskriftsfilerna när vi renderar jobbet.
Varje förfrågan skickas till bas-URL:en https://api.fabrixa.com/v2/integration med båda rubrikerna angivna. GET /ping kontrollerar att token och nyckeln är giltiga innan du gör något annat.
Status 401 betyder att en rubrik saknas eller att token har återkallats. Status 403 betyder att inloggningsuppgifterna är giltiga men att behörighet för resursen saknas.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
Katalogen visar produktvarianter med deras SKU och variant_id. Varje listesvar är inbäddat i det standardiserade links / meta / data kuvertet, så bläddra mellan sidorna med next_page länk. Cache lokalt – katalogen hämtas inte vid varje förfrågan.
Fullständiga uppgifter om fältet finns i Swagger-referens.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Skicka rows (SKU + antal + en PDF-källa), customer och shipping_address. Ställ in dina egna number som referens – utelämna den så skapar vi en. Spara det returnerade Fabrixa-order-id:t tillsammans med din beställning.
Studioproduktioner ersätter sources fil med cart_item_key av den sparade designen; i övrigt är allt identiskt.
POST /v2/integration/orders
{
"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"
}
}
Ange din webhook-URL i kontrollpanelen. Vi skickar en POST-begäran order.created och order.updated till den med hela ordertexten, en x-webhook-signature (HMAC-SHA256) och en x-webhook-topic rubrik. Kontrollera signaturen, returnera 200 snabbt, kör asynkront.
Alla händelser och kodexemplen för verifiering finns på Referens för webhooks.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Felmeddelanden returneras som JSON, aldrig som HTML. Den errors.messages array anger vad som gick fel; vid ett 400-fel listas de fält som inte godkändes.
Valideringsfel, saknade eller återkallade inloggningsuppgifter, otillräckliga behörigheter eller okänd resurs.
30 förfrågningar per applikation och minut. X-RateLimit-Limit och X-RateLimit-Remaining finns med i varje svar.
På serversidan. Försök igen med back-off; om problemet kvarstår, skicka begäran-ID:t till din lösningsingenjör.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa tillåter 30 förfrågningar per applikation och minut; överskrider man denna gräns returneras ett 429 Too Many Requests-svar. Rubrikerna X-RateLimit-Limit och X-RateLimit-Remaining ingår i varje svar, så att en integration kan hålla koll på sin återstående kvot innan gränsen nås.
Fabrixa accepterar bildfiler i formatet PDF, TIFF, JPG eller PNG i RGB-färg, upp till 50 MB och 15 000 px per sida, som kan nås via HTTPS utan autentisering. Flersidiga PDF-filer behandlas som en sida per lager, och Fabrixa hämtar själv filen för att skapa korrekta utskriftsfiler när jobbet renderas.
I WooCommerce går du till Inställningar, sedan Avancerat, sedan REST API och lägger till en nyckel med läs- och skrivbehörighet. Klistra in den genererade ck_-nyckeln, cs_-hemligheten och din butiksdomän i Fabrixa, spara, så synkroniseras beställningarna automatiskt – importreglerna kan ändras senare i kanalinställningarna.
Innan du lägger en första beställning behöver du en åtkomsttoken och en applikationsnyckel från en försäljningskanal, en offentlig HTTPS-webhook-ändpunkt som verifierar HMAC-SHA256-signaturen på varje datapaket samt bildmaterial som är tillgängligt via HTTPS utan autentisering. Alla tre utfärdas eller konfigureras från Fabrixa-instrumentpanelen, och inloggningsuppgifterna genereras omedelbart när försäljningskanalen skapas.
Ett 403-fel innebär att applikationens åtkomsttoken och applikationsnyckel är giltiga men saknar behörighet för den resurs som begärs. Detta skiljer sig från ett 401-fel, vilket innebär att en obligatorisk rubrik saknas eller att token har återkallats; båda kan kontrolleras med en GET /ping-förfrågan innan man går vidare.
För support gällande integration, problem med inloggningsuppgifter eller försäljningskanaler, anpassade krav eller kapacitetsplanering – vänd dig till den tekniska SE-kanalen, inte säljavdelningen. Svar inom en arbetsdag.
