01
Importera samlingen
I Postman: File → Import → Link. Klistra in JSON-URL:en från nedladdningsknappen ovan. Postman lägger till samlingen – med dess variabler – i ditt arbetsområde.
Utvecklare · Postman-samling
Importera collectionen. På API:t inom fem minuter.
En färdig Postman-samling med genomarbetade exempel för Fabrixa Integration API. Ange dina inloggningsuppgifter, klicka dig igenom förfrågningarna och se verkliga svar från API innan du skriver en enda rad integrationskod. Uppdateras i takt med versionerna – samlingen uppdateras när API gör det.
Vad ingår i samlingen?
Varje endpoint, med exempel-payloads.
Sorterade i mappar efter resurs. Varje förfrågan levereras med ett färdigt exempel på förfrågan, de två autentiseringsheaders förinställda och ett sparat exempel på svar – så att du kan förhandsgranska svarets utformning innan du skickar förfrågan.
Autentisering och produkter
- GET /ping — verifiera inloggningsuppgifter
- GET /products — lista och paginering (SKU + variant_id)
- Fullständiga fältscheman i Swagger-referensen
Beställningar
- POST /orders — skapa en beställning
- GET /orders/{id}/fulfillments — spåra produktionen
Studio och webhooks
- GET /v2/studio/customizations/{key}/preview
- Webhook-payload + HMAC-verifiering (exempel)
Importera på 30 sekunder
File → Import → Link → klistra in URL.
02
Öppna fliken Variables
Samlingen levereras med egna variabler — base_url är förifyllt; access_token och application_key är platshållare. Ingen separat miljöfil behövs.
03
Klistra in dina nycklar
Lägg in Application Access Token och Application Key från en försäljningskanal i ditt dashboard, klicka på Save, så kommer varje förfrågan att autentiseras.
Miljövariabler
Vad finns i env-filen.
En bas-URL och två credentials, inbakade i samlingen. Utveckla mot en försäljningskanal och klistra sedan in nycklarna för din live-kanal när du lanserar – samma samling, samma förfrågningar.
Samlingsvariabler
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Autentisering förkonfigurerad
Båda autentiseringsheaders är förinställda i varje request.
Varje begäran medför Authorization: Bearer {{access_token}} och X-Application-Key: {{application_key}}, hämtade från samlingsvariablerna — ingen header-inställning per request. För att byta från en försäljningskanal till en annan räcker det med att redigera dessa två variabler: samma samling, olika nycklar.
Färdiga exempel
Varje förfrågan levereras med ett exempel på innehåll och ett sparat svar.
Samlingen består inte bara av URL-stubbar – varje request har en färdig exempel-body, så att du kan klicka på Send och se riktiga data. Sparade exempelsvar finns i panelen ”Exempel” för att kunna användas offline.
Verifiera autentisering
Kontrollerar först och främst att din applikationsåtkomsttoken och applikationsnyckel är giltiga. Returnerar 200 vid lyckat resultat, 401 om en header saknas.
Visa produkter
Begäran om paginerad katalog. Returnerar produkter sida för sida i links/meta/data-envelopen, med SKU och variant-ID per artikel.
Skapa en beställning
Exempel-body för en beställning på en T-shirt med käll-PDF, customer och shipping_address. Klicka på Send för att se den skapade beställningen med sitt Fabrixa-id.
Spåra produktionen
Visar produktionsstegen per artikel (tryck, fixering, tvätt, sömnad) med statusarna pending / in progress / done / rejected för en lagd beställning.
Studio-förhandsvisning
Returnerar den renderade förhandsgranskningsbilden för en sparad Studio-anpassning – lägg in den direkt som miniatyrbild i varukorgen.
Signaturkontroll
Ett praktiskt exempel på hur man beräknar HMAC-SHA256-signaturen på nytt och jämför den med x-webhook-signature innan bearbetningen.
Versionshantering
Samlingen uppdateras samtidigt som API gör det.
Varje API-utgåva innehåller en uppdaterad samling på samma URL. Importera om för att hämta nya endpoints och exempel-payloads – befintliga förfrågningar i din sparade version fortsätter att fungera tills den aktuella slutpunkten faktiskt fasas ut.
Fast URL
JSON-URL:en för samlingen är permanent. Vid en ny import hämtas den senaste versionen – URL:en ändras aldrig mellan olika utgåvor.
Changelog-referens
Se changelog för motsvarande versionsanteckningar för API – vad som har flyttats, vad som har lagts till och vad som fasas ut.
Policy för utfasning
Endpoints får ett 12 månaders deprecation-fönster. Samlingen markerar föråldrade förfrågningar i beskrivningen så att de är svåra att missa innan något slutar fungera.
Vanliga frågor
Frågor och svar om Postman-samlingen
Hur importerar jag Fabrixa-samlingen i Postman?
I Postman väljer du ”File”, sedan ”Import” och därefter ”Link”, och klistrar in samlingens JSON-URL. Postman lägger till samlingen tillsammans med dess variabler i ditt arbetsområde – ”base_url” är redan ifyllt, medan ”access_token” och ”application_key” är platshållare som du ersätter med ditt eget applikationsåtkomsttoken och din applikationsnyckel.
Vilka slutpunkter ingår i Postman-samlingen ”Fabrixa”?
Samlingen omfattar GET /ping för att verifiera inloggningsuppgifter, GET /products för att visa och paginera katalogen, POST /orders för att skapa en beställning, GET /orders/{id}/fulfillments för att spåra produktionen, förhandsgranskningsändpunkten för Studio samt ett färdigt exempel på verifiering av webhook-signaturer. Den är utvecklad för v2 Integration API och kräver Postman v10 eller senare.
Hur konfigureras autentisering i Fabrixa Postman-samlingen?
Varje begäran i samlingen innehåller redan de två nödvändiga rubrikerna — Authorization: Bearer {{access_token}} och X-Application-Key: {{application_key}} — som hämtas från samlingens variabler. Genom att klistra in ditt applikationsåtkomsttoken och din applikationsnyckel i dessa variabler autentiseras varje förfrågan på en gång, utan att du behöver göra några inställningar för varje enskild förfrågan.
Uppdateras Fabrixa Postman-samlingen när API ändras?
Ja – varje API-utgåva levereras med en uppdaterad samling på samma permanenta URL, så när du importerar om hämtas de senaste slutpunkterna och exempel på datapaket. Slutpunkterna har en 12-månaders övergångsperiod, och samlingen markerar föråldrade förfrågningar i beskrivningen innan något slutar fungera.
Vad returnerar förfrågan GET /orders/{id}/fulfillments?
Den hämtar produktionsstatusen per artikel för en lagd beställning, vilket omfattar steg som tryck, fixering, tvätt och sömnad, där varje steg rapporteras som väntande, pågår, klart eller avvisat. Postman-samlingen innehåller ett praktiskt exempel så att svarets format kan kontrolleras innan det kopplas in i en integration.
Ladda ner och kom igång
Ladda ner samlingen. Skicka din första förfrågan.
Importera sortimentet, ange dina inloggningsuppgifter för försäljningskanalen och skicka din första förfrågan på bara några minuter – du behöver ingen integrationskod för att börja utforska tjänsten.