Gå til hovedinnholdet
En Fabrixa API-forespørsel åpen i Postman — JSON-ordre-payload med de to auth-headerne
Utviklere · Postman-samling

Importer collectionen. På API-et på fem minutter.

En ferdiglaget Postman-samling med praktiske eksempler for Fabrixa-integrasjonen med API. Legg inn påloggingsopplysningene dine, klikk deg gjennom forespørslene og se reelle svar fra API før du skriver en eneste linje med integrasjonskode. Oppdateres i takt med versjonene – samlingen oppdateres når API oppdateres.

Postman v10+ · Autentisering med to overskrifter · v2-integrasjon API

Hva finnes i samlingen?

Hvert endpoint, med eksempler på payload.

Organisert i mapper etter ressurs. Hver forespørsel leveres med et utfylt eksempeltekst, de to auth-headerne forhåndsinnstilt og et lagret eksempelsvar – slik at du kan se svarets form før du sender.

Autentisering og produkter
  • GET /ping — bekreft påloggingsopplysninger
  • GET /products — liste og paginering (SKU + variant_id)
  • Fullstendige feltskjemaer i Swagger-referansen
Bestillinger
  • POST /orders — opprett en ordre
  • GET /orders/{id}/fulfillments — spore produksjonen
Studio og webhooks
  • GET /v2/studio/customizations/{key}/preview
  • Webhook-payload + HMAC-verifisering (eksempel)
Importer på 30 sekunder

Fil → Import → Link → lim inn URL.

01
Importer samlingen

I Postman: File → Import → Link. Lim inn JSON-URL-en fra nedlastingsknappen ovenfor. Postman legger til samlingen – med alle variablene – i arbeidsområdet ditt.

02
Åpne fanen «Variabler»

Samlingen leveres med egne variabler — base_url er forhåndsutfylt; access_token og application_key er plassholdere. Det trengs ingen egen miljøfil.

03
Lim inn nøklene dine

Legg inn applikasjonsadgangstokenet og applikasjonsnøkkelen fra en salgskanal i dashbordet ditt, trykk på «Lagre», og alle forespørsler blir deretter autentisert.

Miljøvariabler

Hva står i env-filen.

Én basis-URL, to påloggingsopplysninger, innebygd i samlingen. Utvikle for én salgskanal, og lim deretter inn nøklene til den aktive kanalen din når du lanserer – samme samling, samme forespørsler.

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 er forhåndskonfigurert

Begge auth-headerne er forhåndsinnstilt på hver forespørsel.

Hver forespørsel innebærer Authorization: Bearer {{access_token}} og X-Application-Key: {{application_key}}, hentet fra samlingsvariablene — ingen konfigurasjon av overskrifter for hver enkelt forespørsel. Å bytte fra én salgskanal til en annen innebærer bare å redigere disse to variablene: samme samling, forskjellige nøkler.

Eksempler med løsninger

Hver forespørsel leveres med et eksempel på innholdet og et lagret svar.

Samlingen består ikke bare av URL-stubber – hver forespørsel har en utfylt eksempeltekst, slik at du kan trykke på «Send» og se reelle data. Lagrede eksempelsvar finnes i «Eksempler»-panelet, slik at du kan bruke dem som referanse når du er uten nettilgang.

GET /ping

Bekreft autentisering

Kontrollerer først og fremst at applikasjonens tilgangstoken og applikasjonsnøkkel er gyldige. Returnerer 200 ved vellykket utførelse, 401 hvis en header mangler.

GET /products

Vis produkter

Forespørsel om katalog med sideinndeling. Returnerer produktene side for side i «links/meta/data»-konvolutten, med SKU og variant-ID for hver vare.

POST /orders

Opprett en bestilling

Eksempel på ordretekst for en bestilling av én T-skjorte, med kilde-PDF, kunde- og leveringsadresse. Trykk på «Send» for å se den opprettede bestillingen med ID-en Fabrixa.

GET /orders/{id}/fulfillments

Spor produksjonen

Henter produksjonstrinnene per vare (trykk, fiksering, vask, sying) med statusene «ventende», «pågår», «ferdig» og «avvist» for en lagt ordre.

/studio/.../preview

Forhåndsvisning av studioet

Returnerer det renderte forhåndsvisningsbildet for en lagret Studio-tilpasning — du kan dra det rett inn i en miniatyrbilde i handlekurven.

Bekreftelse av webhook

Signaturkontroll

Et eksempel på hvordan du beregner HMAC-SHA256-signaturen på nytt og sammenligner den med x-webhook-signature før behandlingen.

Versjonering

Samlingen oppdateres når API oppdateres.

Hver API-utgivelse inneholder en oppdatert samling på samme URL. Importer på nytt for å hente nye endpointer og eksempler på payloader — eksisterende forespørsler i den lagrede versjonen din vil fortsette å fungere helt til det aktuelle endpointet faktisk blir utfaset.

Fast URL

JSON-URL-en for samlingen er permanent. Når du importerer på nytt, hentes den nyeste versjonen – URL-en endres aldri mellom utgivelsene.

Referanse til endringslogg

Se endringslogg for de tilhørende versjonsnotatene til API – hva som er flyttet, hva som er lagt til og hva som er utfaset.

Retningslinjer for utfasing

Endpointer får en 12-måneders utfasingsperiode. Samlingen markerer utfasede forespørsler i beskrivelsen, slik at de er vanskelige å overse før noe slutter å fungere.

Last ned og start

Hent samlingen. Send din første forespørsel.

Importer samlingen, legg inn påloggingsopplysningene for salgskanalen din og send din første forespørsel på få minutter — du trenger ingen integrasjonskode for å komme i gang.