Gå til hovedinnholdet
En Fabrixa API-forespørsel på skjermen — JSON-ordredata med autentiseringshoder, mot vevd tekstil
API-dokumentasjon

Ett endpoint. Uendelig mange produkter.

Hver Fabrixa-SKU, hvert stoff, hver finish – adresserbar via ett dokumentert REST API. JSON inn, JSON ut. Webhooks for hver tilstandsovergang. Selvbetjente API-nøkler – opprett en salgskanal og begynn å bygge.

REST · JSON · Webhooks · Studio-innbygging · Swagger

Hva du får

Utformet med utgangspunkt i hvordan produksjonen faktisk foregår.

En dokumentert REST API som gjenspeiler plattformen – bestillinger, ordrebehandling, Studio-tilpasning og webhooks. JSON inn, JSON ut. Bruk den sammen med dashbordet, eller styr alt programmatisk.

01
Bestillinger
POST /v2/integration/orders

Send inn en bestilling med rader, kilde-PDF-filer, kundeopplysninger og leveringsadresse. Returnerer Fabrixa-bestillings-ID. Valgfrie felt for fraktetikett og sporingsnummer.

02
Fulfilment
GET /orders/{id}/fulfillments

Hent produksjonsstatus per varelinje: hvert trinn (trykk, fiksering, vask, sying) med statusene «ventende», «pågår», «ferdig» og «avvist». Eller abonner på webhooks for push-varsler.

03
Studio
iframe-innbygging

Integrer Fabrixa Studio i nettbutikken din. Kundene kan tilpasse produktene i sanntid, med postMessage-hendelser for «legg til i handlekurven» og «tilbake», samt en forhåndsvisnings-URL for miniatyrbilder i handlekurven.

04
Webhooks
order.created / order.updated

To emner: HMAC-SHA256-signerte payloader, fullstendig ordretekst, levering med 10 forsøk og back-off.

Hurtigstart

Legg inn en bestilling med én POST.

Autentisert forespørsel, validert datapakke, plass reservert i produksjonskøen. Bekreftelse mottas i løpet av millisekunder – kundens bestilling er nå i gang.

Fullstendig skjema, alle endpointer, feilkoder, rate limiter og integrasjonseksempler finnes i den tekniske dokumentasjonen.

POST /v2/integration/orders
// POST https://api.fabrixa.com/v2/integration/orders
// Authorization: Bearer APPLICATION_ACCESS_TOKEN
// X-Application-Key: APPLICATION_KEY
{
  "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"
  }
}
Integrasjonsprosess

Live på to uker. Ingen proxy, ingen middleware.

Direkte REST-integrasjon i plattformen din. Ingen SDK nødvendig, ingen proxy-server, ingen tredjeparts-kobling. Standard HTTP fra din systemstabel til vår.

01
Legitimasjon

Få et applikasjons-tilgangstoken og en applikasjonsnøkkel ved å opprette en salgskanal i dashbordet ditt. Begge deler er påkrevd ved hver forespørsel: «Bearer»-token i «Authorization», og applikasjonsnøkkel i «X-Application-Key».

02
Katalog

Gå gjennom den interaktive Swagger-referansen for å finne variantene SKUs for produktene du ønsker å selge, samt filter- og pagineringsmønstre.

03
Bestillinger

Ved kassen sender du en POST-forespørsel med rader, kilder (PDF-URL-er), kunde og shipping_address. Lagre den returnerte Fabrixa-ordre-ID-en sammen med din egen ordrereferanse.

04
Webhooks

Opprett et offentlig POST-endpoint. Vi signerer hver enkelt payload med HMAC-SHA256 (x-webhook-signature), slik at du kan bekrefte ektheten før du behandler den.

05
Studio

Valgfritt: Sett inn Fabrixa Studio-iframe på produktsiden din. Kundene tilpasser produktet i sanntid og legger til sine tilpasninger i bestillingen ved hjelp av en POST-forespørsel.

Ressurser for utviklere

Alt det tekniske teamet ditt trenger.

Fullstendig API-referanse

Fullstendig dokumentasjon av endpointer, forespørsels- og svarskjemaer, feilkoder, rate limiter, autentisering, Studio-integrasjon og webhook-kontrakter – med et Swagger-grensesnitt i sanntid.

Åpne dokumentasjonen →

Utvikle med tanke på en salgskanal

Opprett en egen salgskanal som du kan bygge videre på – send inn testbestillinger, sjekk at webhook-meldingene kommer frem, test spesielle tilfeller – og send deretter ekte trafikk til den aktive kanalen din. Nøklene dine er klare så snart du oppretter kanalen – uten at du trenger å sende inn en forespørsel.

Opprett din konto →

Postman-samling

Forhåndskonfigurert samling av forespørsler med eksempler på payload og autentisering. Importer den inn i testarbeidsflyten din.

Få tak i samlingen →
Sikkerhet

Autentisering med to headere. Signerte webhooks. Rate limit.

Standardpraksis, ingen overraskelser. Hver forespørsel autentiseres med både et Bearer-token og en applikasjonsnøkkel. Hver webhook er HMAC-signert for verifisering, med forutsigbare rate limiter per applikasjon.

Tilgangstoken for applikasjonen

Bearer-token i Authorization-headeren. Identifiserer applikasjonen som sender forespørselen.

Applikasjonsnøkkel

Sendes i X-Application-Key-overskriften. Begge er obligatoriske i hver forespørsel — hvis en av dem mangler, returneres feilkode 401.

TLS-kryptering

api.fabrixa.com bruker utelukkende HTTPS. Forespørsler i klartekst avvises ved inngangen.

Webhook-signaturer

Hver webhook er signert med HMAC-SHA256, og signaturen sendes i x-webhook-signature-overskriften. Kontroller dette før du behandler dataene.

Ratebegrensninger

30 forespørsler per applikasjon per minutt. X-RateLimit-Limit og X-RateLimit-Remaining returneres i hvert svar.

Nye forsøk på webhook

Opptil 10 leveringsforsøk ved svar som ikke er av typen 2xx eller 3xx. Webhooken deaktiveres etter det 10. mislykkede forsøket.

Begynn å bygge

Opprett en salgskanal og begynn å bygge opp i dag.

Registrer deg, opprett en salgskanal, så er API-påloggingsopplysningene dine klare med en gang. Trenger du hjelp? Våre løsningsingeniører svarer innen 24 timer – de fleste teamene er i drift innen to uker.