Gå direkte til hovedindholdet
En Fabrixa API-anmodning, der er åben i Postman — JSON-payload i ordren med de to auth-headers
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 changelog 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.

Ofte stillede spørgsmål

»The Postman«-samlingen, besvaret

Hvordan importerer jeg Fabrixa Postman-samlingen?

I Postman skal du vælge »File«, derefter »Import« og så »Link« og indsætte samlingens JSON-URL. Postman tilføjer samlingen sammen med dens variabler til dit arbejdsområde — »base_url« er allerede udfyldt, mens »access_token« og »application_key« er pladsholdere, som du skal erstatte med dit eget applikationsadgangstoken og din applikationsnøgle.

Hvilke endpoints er inkluderet i Fabrixa-samlingen i Postman?

Samlingen omfatter GET /ping til verifikation af legitimationsoplysninger, GET /products til visning og paginering af kataloget, POST /orders til oprettelse af en ordre, GET /orders/{id}/fulfillments til sporing af produktionen, Studio-forhåndsvisningsendepunktet samt et eksempel på verifikation af en webhook-signatur. Den er udviklet til v2 Integration API og kræver Postman v10 eller nyere.

Hvordan er godkendelsen konfigureret i Fabrixa Postman-samlingen?

Hver anmodning i samlingen indeholder allerede de to påkrævede headere — Authorization: Bearer {{access_token}} og X-Application-Key: {{application_key}} — som hentes fra samlingens variabler. Når du indsætter dit applikationsadgangstoken og din applikationsnøgle i disse variabler, godkendes hver eneste anmodning på én gang, uden at der skal foretages opsætning for hver enkelt anmodning.

Bliver Fabrixa Postman-samlingen opdateret, når API ændres?

Ja — hver API-udgivelse indeholder en opdateret samling på den samme faste URL, så når man importerer den igen, hentes de nyeste endpoints og eksempel-payloads. Endpoints har en udfasningsperiode på 12 måneder, og samlingen markerer udfasede anmodninger i beskrivelsen, inden der opstår problemer.

Hvad returnerer GET-anmodningen /orders/{id}/fulfillments?

Den henter produktionsstatus for hver enkelt vare i en afgivet ordre, herunder trin som tryk, fixering, vask og syning, hvor hvert trin angives som »afventende«, »i gang«, »færdig« eller »afvist«. Postman-samlingen indeholder et eksempel, så man kan kontrollere svarets format, inden det integreres i et system.

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.