Gå direkte til hovedindholdet
En Fabrixa API-anmodning på skærmen — JSON-ordre-payload med auth-headers, foran vævet tekstil
API-dokumentation

Ét endpoint. Uendelige produkter.

Hvert Fabrixa-SKU, hvert stof, hver finish — alt kan styres via én dokumenteret REST API. JSON ind, JSON ud. Webhooks for hver tilstandsovergang. Selvbetjeningsnøgler til API — opret en salgskanal, og kom i gang med at udvikle.

REST · JSON · Webhooks · Studio-indlejring · Swagger

Hvad du får

Udviklet med udgangspunkt i, hvordan produktionen rent faktisk fungerer.

En dokumenteret REST API, der afspejler platformen — ordrer, fulfilment, Studio-tilpasning og webhooks. JSON ind, JSON ud. Brug den sammen med dashboardet, eller styr det hele programmatisk.

01
Ordrer
POST /v2/integration/orders

Indsend en ordre med rækker, kilde-PDF-filer, kundeoplysninger og leveringsadresse. Returnerer Fabrixa-ordre-ID’et. Valgfrie felter til fragtmærkat og sporingsoplysninger.

02
Fulfilment
GET /orders/{id}/fulfillments

Vis produktionsstatus pr. linjepost: hvert trin (tryk, fiksering, vask, syning) med statusserne pending / in progress / done / rejected. Eller tilmeld dig webhooks for push-beskeder.

03
Studio
iframe-indlejring

Integrer Fabrixa Studio i din webshop. Kunderne kan tilpasse produkterne i realtid ved hjælp af postMessage-begivenheder til »tilføj til kurv« og »tilbage«, samt en forhåndsvisnings-URL til miniaturer i kurven.

04
Webhooks
order.created / order.updated

To topics, HMAC-SHA256-signerede payloads, hele ordrebody, levering med 10 forsøg og back-off.

Hurtigstart

Afgiv en ordre med ét POST-kald.

Autentificeret anmodning, valideret payload, plads reserveret i produktionskøen. Bekræftelse modtages inden for få millisekunder — din kundes ordre er nu sat i gang.

Det fulde skema, alle endpoints, fejlkoder, rate limits og integrationseksempler findes i den tekniske dokumentation.

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"
  }
}
Integrationsforløb

Lanceres om to uger. Ingen proxy, ingen middleware.

Direkte REST-integration i din platform. Intet SDK kræves, ingen proxyserver, ingen tredjeparts-connector. Standard HTTP fra din platform til vores.

01
Adgangsoplysninger

Du kan få et Application Access Token og en Application Key ved at oprette en salgskanal i dit kontrolpanel. Begge dele skal angives ved hver anmodning: Bearer-token i Authorization og Application Key i X-Application-Key.

02
Katalog

Gennemse den interaktive Swagger-reference for at finde variant-SKU’er for de produkter, du ønsker at sælge, samt mønstre for filtrering og paginering.

03
Ordrer

Ved kassen skal du sende en POST-anmodning med rows, sources (PDF-URL’er), customer og shipping_address. Gem det returnerede Fabrixa-ordre-ID sammen med din egen ordrereference.

04
Webhooks

Opret et offentligt POST-endpoint. Vi signerer hver enkelt payload med HMAC-SHA256 (x-webhook-signature), så du kan kontrollere ægtheden, inden du behandler den.

05
Studio

Valgfrit: Indsæt Fabrixa Studio-iframe på din produktside. Kunderne tilpasser produktet i realtid; deres tilpasninger knyttes til ordren ved POST-anmodningen.

Ressourcer til udviklere

Alt, hvad dit ingeniørteam har brug for.

Fuld API-reference

Komplet endpoint-dokumentation, anmodnings-/svarskemaer, fejlkoder, rate limits, autentificering, integration i Studio og webhook-kontrakter — med en Swagger-grænseflade i realtid.

Åbn dokumentationen →

Udvikle med henblik på en salgskanal

Opret en dedikeret salgskanal, som du kan bygge videre på — indsend testordrer, kontroller, at webhooks leveres, og valider grænsetilfælde — og diriger derefter reel trafik til din live-kanal. Dine nøgler er klar, så snart du opretter kanalen — der er ikke behov for at anmode om dem.

Opret din konto →

Postman-samling

En forudkonfigureret samling af anmodninger med eksempel-payloads og autentificering. Importer den til din testworkflow.

Hent samlingen →
Sikkerhed

Autentificering med to headere. Signerede webhooks. Rate limits håndhæves.

Standardprocedurer, ingen overraskelser. Hver anmodning godkendes med både et Bearer-token og en applikationsnøgle. Hver webhook er HMAC-signeret til verifikation, med forudsigelige hastighedsbegrænsninger pr. applikation.

Application Access Token

Bearer-token i Authorization-headeren. Identificerer den kaldende applikation.

Applikationsnøgle

Sendes i X-Application-Key-headeren. Begge er obligatoriske i hver anmodning — mangler en af dem, returneres fejlkode 401.

TLS-kryptering

Der anvendes udelukkende HTTPS på api.fabrixa.com. Anmodninger i klartekst afvises ved indgangen.

Webhook-signaturer

Hver webhook er signeret med HMAC-SHA256 og sendes i x-webhook-signature-headeren. Kontroller signaturen, inden du behandler den.

Rate limits

30 anmodninger pr. applikation pr. minut. X-RateLimit-Limit og X-RateLimit-Remaining returneres i hvert svar.

Webhook-retries

Op til 10 leveringsforsøg ved et svar, der ikke er en 2xx- eller 3xx-kode. Webhooken deaktiveres efter det 10. mislykkede forsøg.

Ofte stillede spørgsmål

Integrationen API, besvaret

Hvordan logger jeg ind på Fabrixa og API?

Hver anmodning skal indeholde to headere: et applikationsadgangstoken, der sendes som et »Bearer«-token i »Authorization«-headeren, og en applikationsnøgle i »X-Application-Key«. Begge genereres i det øjeblik, du opretter en salgskanal i Fabrixa-dashboardet, og en anmodning afvises med en 401-fejl, hvis en af disse headere mangler.

Kan jeg afprøve Fabrixa og API, før jeg afgiver egentlige ordrer?

Ja — opret en dedikeret salgskanal, som du kan bygge videre på, indsend testordrer, kontroller, at webhooks leveres korrekt, og test grænsetilfælde. Når det hele fungerer, kan du derefter omdirigere den reelle trafik til din live-kanal. Når du registrerer og opretter denne kanal, bliver dit applikationsadgangstoken og din applikationsnøgle straks tilgængelige uden behov for en separat anmodning.

Er Fabrixa-integrationen API krypteret med HTTPS?

Ja — API fungerer udelukkende via HTTPS på api.fabrixa.com, og enhver anmodning i klartekst afvises ved indgangen. Hver anmodning autentificeres desuden med både et Bearer-token og en applikationsnøgle, og hver webhook-payload signeres med HMAC-SHA256, så den kan verificeres inden behandling.

Hvad returnerer et POST-anrop til /v2/integration/orders?

Et godkendt POST-anrop til /v2/integration/orders validerer dataindholdet, reserverer en plads i produktionskøen og returnerer en bekræftelse med Fabrixa-ordre-ID’et i millisekunder samt valgfrie felter til fragtmærkat og sporingsoplysninger. Ordrebehandlingen kan derefter spores pr. varelinje eller sendes til dig via webhooks.

Har jeg brug for et SDK eller en proxy for at kunne integrere med Fabrixa og API?

Nej — fabrixa’s integration er en direkte REST-forbindelse via standard-HTTP, hvor der hverken kræves et SDK, en proxyserver eller en tredjeparts-connector. Du kommunikerer direkte med fabrixa fra dit eget system ved hjælp af JSON-anmodninger og -svar, med webhooks til statusændringer.

Kom i gang

Opret en salgskanal, og kom i gang allerede i dag.

Opret konto, opret en salgskanal, og dine API-adgangsoplysninger er klar med det samme. Brug for hjælp? Vores løsningsingeniører svarer inden for 24 timer — de fleste teams er klar til drift inden for to uger.