01
Tilaukset
POST /v2/integration/orders
Lähetä tilaus, joka sisältää rivit, lähde-PDF-tiedostot, asiakastiedot ja toimitusosoitteen. Palauttaa Fabrixa-tilausnumeron. Valinnaiset kentät toimitusetiketille ja seurannalle.
API-dokumentaatio
Yksi endpoint. Loputtomasti tuotteita.
Jokainen Fabrixan SKU, jokainen kangas, jokainen viimeistely — kaikki hallittavissa yhden dokumentoidun REST API -rajapinnan kautta. JSON-tulo, JSON-lähtö. Webhookit jokaiselle tilanmuutokselle. Itsepalveluperiaatteella toimivat API-avaimet — luo myyntikanava ja aloita rakentaminen.
Mitä saat
Suunniteltu tuotannon todellisten toimintatapojen pohjalta.
Dokumentoitu REST API -rajapinta, joka heijastaa alustan toimintaa — tilaukset, toimitus, Studio-mukautukset ja webhookit. Sisään JSON, ulos JSON. Käytä sitä yhdessä hallintapaneelin kanssa tai ohjaa kaikkea ohjelmoimalla.
02
Fulfilment
GET /orders/{id}/fulfillments
Tuotantotilan hakeminen rivikohtaisesti: jokainen vaihe (painatus, kiinnitys, pesu, ompelu) ja niiden tilat (odottaa käsittelyä / käynnissä / valmis / hylätty). Tai tilaa webhookit saadaksesi ilmoitukset reaaliaikaisesti.
03
Studio
iframe-upotus
Sisällytä Fabrixa Studio verkkokauppaasi. Asiakkaat voivat muokata tuotteita reaaliajassa: käytössä ovat postMessage-tapahtumat tuotteiden lisäämistä ostoskoriin ja paluuta varten sekä esikatselu-URL ostoskorin pikkukuville.
04
Webhookit
order.created / order.updated
Kaksi aihetta: HMAC-SHA256-allekirjoitetut payloadit, koko tilausrunko sekä 10 uudelleenyritystä back-off-viiveellä.
Pikaopas
Tee tilaus yhdellä POST-pyynnöllä.
Pyyntö on todennettu, data on vahvistettu, paikka tuotantojonossa on varattu. Vahvistus saapuu muutamassa millisekunnissa — asiakkaasi tilaus on nyt käsiteltävänä.
Teknisessä dokumentaatiossa on täydellinen skeema, kaikki endpointit, virhekoodit, rate limitit ja integrointiesimerkit.
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" } }
Integrointiprosessi
Käyttövalmis kahdessa viikossa. Ei välityspalvelinta, ei väliohjelmistoa.
Suora REST-integraatio alustallesi. Ei vaadita SDK:ta, välityspalvelinta eikä kolmannen osapuolen liitintä. Tavallinen HTTP-yhteys omasta järjestelmästäsi meidän järjestelmäämme.
01
Tunnistetiedot
Hanki sovelluksen pääsytunnus ja sovelluksen avain luomalla myyntikanava hallintapaneelissasi. Molemmat ovat pakollisia jokaisessa pyynnössä: Bearer-tunnus valtuutuksessa (Authorization) ja sovelluksen avain kentässä X-Application-Key.
02
Tuoteluettelo
Selaa reaaliaikaista Swagger-viitekokoelmaa löytääksesi myytävien tuotteiden varianttien SKU:t sekä suodatus- ja sivutusmallit.
03
Tilaukset
Kun asiakas siirtyy kassalle, lähetä POST-pyyntö, joka sisältää rivit, lähteet (PDF-URL-osoitteet), asiakastiedot ja toimitusosoitteen. Tallenna palautettu Fabrixa-tilausnumero oman tilausviitteesi yhteyteen.
04
Webhookit
Julkaise julkinen POST-endpoint. Allekirjoitamme jokaisen payloadin HMAC-SHA256-algoritmilla (x-webhook-signature), jotta voit tarkistaa sen aitouden ennen käsittelyä.
05
Studio
Valinnainen: lisää Fabrixa Studio -iframe tuotesivullesi. Asiakkaat voivat muokata tuotetta reaaliaikaisesti; liitä heidän muokkauksensa tilaukseen POST-pyynnöllä.
Kehittäjien resurssit
Kaikki, mitä suunnittelutiimisi tarvitsee.
Koko API-dokumentaatio
Kattava dokumentaatio päätepisteistä, pyyntö- ja vastausmallit, virhekoodit, rate limitit, todennus, Studio-upotus ja webhook-sopimukset — reaaliaikaisella Swagger-käyttöliittymällä.
Avaa dokumentaatio →Kehitä myyntikanavan pohjalta
Luo erillinen myyntikanava, jota voit kehittää – lähetä testitilauksia, tarkista webhook-ilmoitusten toimitus ja testaa ääritapauksia – ja ohjaa sitten todellista liikennettä tuotantokanavallesi. Avaimet ovat käytettävissä heti kanavan luomisen jälkeen – erillistä pyyntövaihetta ei tarvita.
Luo tili →Postman-kokoelma
Valmiiksi määritetty pyyntökokoelma, joka sisältää esimerkkipayloadit ja todennuksen. Tuo se testausprosessiisi.
Hanki kokoelma →
Turvallisuus
Kahden otsikon todennus. Allekirjoitetut webhookit. Rate limitit.
Vakiintuneet käytännöt, ei yllätyksiä. Jokainen pyyntö todennetaan sekä Bearer-tunnuksella että sovellusavaimella. Jokainen webhook on varmennettu HMAC-allekirjoituksella, ja sovelluskohtaiset käyttörajoitukset ovat ennakoitavissa.
Sovelluksen pääsytunnus
Authorization-otsikossa oleva Bearer-tunnus. Tunnistaa kutsuvan sovelluksen.
Sovelluksen avain
Lähetetään X-Application-Key-otsikossa. Molemmat ovat pakollisia jokaisessa pyynnössä — jos jompikumpi puuttuu, palautetaan virhekoodi 401.
TLS-salaus
api.fabrixa.com-palvelussa käytetään yksinomaan HTTPS-yhteyttä. Salaamattomat pyynnöt hylätään reunapalvelimella.
Webhook-allekirjoitukset
Jokainen webhook on allekirjoitettu HMAC-SHA256-menetelmällä, ja allekirjoitus lähetetään x-webhook-signature-otsikossa. Tarkista allekirjoitus ennen käsittelyä.
Rate limitit
30 pyyntöä sovellusta kohti minuutissa. X-RateLimit-Limit- ja X-RateLimit-Remaining-tiedot palautetaan jokaisessa vastauksessa.
Webhook-uudelleenkokeilut
Jopa 10 toimitusyritystä, jos vastaus ei ole 2xx- tai 3xx-koodi. Webhook poistetaan käytöstä 10. epäonnistumisen jälkeen.
Aloita rakentaminen
Luo myyntikanava ja aloita sen rakentaminen jo tänään.
Rekisteröidy, luo myyntikanava, ja API-käyttötunnuksesi ovat heti käytettävissä. Tarvitsetko apua? Solutions Engineer -tiimimme vastaa 24 tunnin kuluessa — useimmat tiimit ovat toiminnassa kahden viikon kuluessa.