Gå direkte til hovedindholdet
En Fabrixa API-anmodning, der er åben i Postman — JSON-payload i ordren med de to godkendelseshovedlinjer
Udviklere · Postman-samling

Importér collectionen. I gang med API på fem minutter.

En færdiglavet Postman-samling med praktiske eksempler til Fabrixa-integrationen med API. Indtast dine loginoplysninger, klik dig igennem anmodningerne, og se reelle svar fra API, inden du skriver en eneste linje integrationskode. Opdateres på tværs af versioner — samlingen opdateres, når API opdateres.

Postman v10+ · Autentificering med to headere · v2 Integration API

Hvad indeholder samlingen?

Hvert endpoint, med eksempel-payloads.

Inddelt i mapper efter ressource. Hver anmodning leveres med et udfyldt eksempel på anmodningsteksten, de to autentificeringsheadere forudindstillet og et gemt eksempel på et svar — så du kan få et indblik i svarets form, inden du sender anmodningen.

Auth & produkter
  • GET /ping — bekræft legitimationsoplysninger
  • GET /products — liste og paginering (SKU + variant_id)
  • Fuldfeltsskemaer i Swagger-referencen
Ordrer
  • INDLÆG /orders — opret en ordre
  • GET /orders/{id}/fulfillments — spor produktionen
Studio og webhooks
  • GET /v2/studio/customizations/{key}/preview
  • Webhook-payload + HMAC-verifikation (eksempel)
Import på 30 sekunder

File → Import → Link → indsæt URL.

01
Importer samlingen

I Postman: File → Import → Link. Indsæt JSON-URL’en fra downloadknappen ovenfor. Postman tilføjer samlingen — sammen med dens variabler — til dit arbejdsområde.

02
Åbn fanen »Variabler«

Samlingen leveres med sine egne variabler — base_url er forudfyldt; access_token og application_key er pladsholdere. Der kræves ingen separat miljøfil.

03
Indsæt dine nøgler

Indsæt Application Access Token og Application Key fra en salgskanal i dit dashboard, klik på »Gem«, og alle anmodninger bliver derefter godkendt.

Miljøvariabler

Hvad står der i env-filen.

Én basis-URL, to adgangskoder, indbygget i samlingen. Udvikl med udgangspunkt i én salgskanal, og indsæt derefter nøglerne til din live-kanal, når du lancerer – samme samling, samme forespørgsler.

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"
}
Autentificering er forudkonfigureret

Begge autentificeringsheadere er forudindstillet ved hver anmodning.

Hver anmodning indebærer Authorization: Bearer {{access_token}} og X-Application-Key: {{application_key}}, hentet fra samlingsvariablerne — ingen opsætning af headere pr. anmodning. At skifte fra én salgskanal til en anden kræver blot, at man redigerer disse to variabler: samme samling, forskellige nøgler.

Eksempler med løsninger

Hver anmodning leveres med en eksempeltekst og et gemt svar.

Samlingen består ikke kun af URL-stubber — hver forespørgsel har en udfyldt eksempeltekst, så du kan klikke på »Send« og se reelle data. Gemte eksempelsvar findes i panelet »Eksempler«, hvor du kan se dem, selv når du ikke er online.

GET /ping

Bekræft autentificering

Kontrollerer først og fremmest, om dit Application Access Token og din Application Key er gyldige. Returnerer 200 ved succes, 401 hvis en header mangler.

GET /products

Vis produkter

Anmodning om katalog med sideinddeling. Returnerer produkterne side for side i links/meta/data-konvolutten, med SKU og variant-id for hver vare.

POST /orders

Opret en ordre

Eksempel på en ordre på én T-shirt med en kilde-PDF, kundeoplysninger og leveringsadresse. Klik på »Send« for at se den oprettede ordre med id’et Fabrixa.

GET /orders/{id}/fulfillments

Produktionsoversigt

Viser produktionstrin pr. vare (tryk, fiksering, vask, syning) med statusserne pending / in progress / done / rejected for en afgivet ordre.

/studio/.../forhåndsvisning

Fabrixa Studio-forhåndsvisning

Returnerer det renderede forhåndsvisningsbillede for en gemt Studio-tilpasning — du kan blot indsætte det direkte i en indkøbskurvsminiature.

Bekræftelse af webhook

Signaturkontrol

Et eksempel på, hvordan man genberegner HMAC-SHA256-signaturen og sammenligner den med x-webhook-signature inden behandlingen.

Versionsstyring

Samlingen opdateres, når API opdateres.

Hver API-udgivelse indeholder en opdateret samling på samme URL. Importer på ny for at hente nye endpoints og eksempel-payloads — eksisterende anmodninger i din gemte version fortsætter med at fungere, indtil det pågældende endpoint rent faktisk udgår.

Fast URL

URL’en til JSON-samlingen er permanent. Ved genimport hentes den nyeste version — URL’en ændrer sig aldrig mellem udgivelser.

Henvisning til ændringslog

Se ændringslog for de tilhørende versionnoter til API — hvad der er flyttet, hvad der er tilføjet, og hvad der udfases.

Politik for udfasning

Endpoints får en 12-måneders udfasningsperiode. Samlingen markerer udfasede anmodninger i beskrivelsen, så de er svære at overse, inden der opstår fejl.

Download og kom i gang

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

Importer samlingen, indtast dine salgskanaloplysninger, og send din første forespørgsel på få minutter — der kræves ingen integrationskode for at komme i gang.