On kaksi tapaa lähettää tilauksia Fabrixa-yhtiölle: yhdistä jo käyttämäsi verkkokauppa – Shopify tai WooCommerce – ilman koodausta tai rakenna se suoraan API-integraation avulla. Tässä oppaassa käsitellään molempia vaihtoehtoja: voit yhdistää myyntikanavan muutamassa minuutissa tai edetä valtuutuksesta toimitukseen viidessätoista minuutissa.
Useimmat kaupat eivät koskaan käytä API-mallia. Lisää Fabrixa myyntikanavaksi, niin kaupan tilaukset siirtyvät suoraan tuotantoon — tuotteet synkronoidaan, tilatiedot päivitetään automaattisesti, eikä koodia tarvitse kirjoittaa tai ylläpitää. Jäljempänä kuvattu API-reitti on tarkoitettu räätälöityille verkkokaupoille ja POD-alustoille.
Avaa hallintapaneelissasi Create channel ja valitse integraatiotyyppi. Jokaisella kanavalla on omat tuotteensa, tuodut tilauksensa ja tuontisäännöt – voit liittää niin monta kanavaa kuin käytät.
Avaimia ei tarvitse kopioida. Hyväksy Fabrixa Shopify-hallintapaneelissasi, niin yhteys on valmis.
Create channel, valitse Shopify.WordPress-verkkokauppa yhdistetään luku-/kirjoitusoikeuksin varustetulla REST-avainparilla, joka luodaan WooCommerce-ohjelmistossa ja liitetään Fabrixa-palveluun kerran.
Settings → Advanced → REST API → Add key ja Luku/kirjoitus käyttöoikeudet.ck_ avain, cs_ salasana ja verkkokauppasi verkkotunnus Fabrixa:hen.Myytkö räätälöityjä tuotteita? Fabrixa Studio — white-label-suunnittelueditori — on saatavilla myös Shopify- ja WooCommerce-verkkokaupoissa, joten asiakkaasi voivat räätälöidä tuotteita brändisi nimissä. Katso Fabrixa Studio →
”Connected stores” -kanavat näkyvät API- ja kumppanikanavien vieressä Kanavat-näkymässä — synkronoidut tuotteet, vastaanotetut tilaukset, viimeksi tuotu viitenumero ja liikevaihto kanavakohtaisesti. Voit siirtää kanavan luonnosvaiheesta julkaisuvaiheeseen, kun olet valmis; mikään myöhemmissä vaiheissa ei muutu.
Aiotko rakentaa räätälöidyn verkkokaupan vai oman POD-alustan? Tämän oppaan loppuosa käsittelee API-mallia – tunnistautumisesta toimitukseen neljässä vaiheessa.
Kolme asiaa vievät sinut nollasta toimivaan tilaukseen. Ne kaikki hoidetaan Fabrixa-hallintapaneelistasi tai ratkaisusuunnittelijasi toimesta.
Sovelluksen pääsytunnus ja sovelluksen avain. Molemmat vaaditaan jokaisessa pyynnössä — tunnus Authorization-otsikossa ja avain X-Application-Key-otsikossa. Luo myyntikanava hallintapaneelissasi, niin saat ne heti käyttöösi — erillistä pyyntöä ei tarvita.
Julkisesti saavutettava HTTPS-päätelaitteisto, joka hyväksyy JSON-POST-pyyntöjä. Localhost toimii kehitysvaiheessa tunnelin kautta. Tarkistat jokaisen datapaketin HMAC-SHA256-allekirjoituksen ennen sen käsittelyä.
Tiedostosi — PDF, TIFF, JPG tai PNG — on saatavilla HTTPS-yhteyden kautta ilman tunnistautumista. RGB-värit, enintään 50 MB ja 15 000 pikseliä per sivu. Monisivuisissa PDF-tiedostoissa on yksi sivu kerrosta kohti. Haemme tiedoston ja luomme oikeat tulostustiedostot, kun renderoimme työn.
Jokainen pyyntö ohjataan perus-URL-osoitteeseen https://api.fabrixa.com/v2/integration kun molemmat otsikot on määritetty. GET /ping varmistaa, että tunnus ja avain ovat kelvollisia, ennen kuin teet mitään muuta.
A 401 tarkoittaa, että otsikko puuttuu tai tunnus on peruutettu. A 403 tarkoittaa, että tunnistetiedot ovat kelvolliset, mutta resurssin käyttöoikeudet puuttuvat.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
Tuoteluettelo palauttaa tuotevariantit niiden SKU-koodien ja variant_id. Jokainen listavastaus on kääritty standardin mukaisella links / meta / data kirjekuori, joten sivunumerointi tehdään next_page linkki. Tallennetaan välimuistiin paikallisesti — luetteloa ei ladata jokaisen pyynnön yhteydessä.
Kattavat tiedot kentästä löytyvät Swagger-viite.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Lähetä rows (SKU + määrä + lähde-PDF), customer ja shipping_address. Määritä oma number viitteenä — jos jätät sen pois, järjestelmä luo sen automaattisesti. Tallenna palautettu Fabrixa-tilausnumero tilaukseesi.
Studiot vaihtavat tilauksiaan sources ... cart_item_key — kaikki muu on samanlaista.
POST /v2/integration/orders
{
"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"
}
}
Määritä webhook-URL hallintapaneelissa. Lähetämme POST-pyynnön order.created ja order.updated siihen koko tilauksen sisältö, ja x-webhook-signature (HMAC-SHA256) ja x-webhook-topic otsikko. Tarkista allekirjoitus, palaa 200 nopeasti, käsittele asynkronisesti.
Kaikki tapahtumat ja vahvistuskatkelmat löytyvät webhookien ohjeet.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Virheet palautetaan JSON-muodossa, ei koskaan HTML-muodossa. errors.messages array-muuttuja kertoo, mikä epäonnistui; virhekoodin 400 yhteydessä se luettelee kentät, joiden tarkistuksessa ilmeni virheitä.
Vahvistusvirhe, puuttuvat tai peruutetut tunnistetiedot, riittämättömät käyttöoikeudet tai tuntematon resurssi.
30 pyyntöä sovellusta kohti minuutissa. X-RateLimit-Limit ja X-RateLimit-Remaining ovat mukana jokaisessa vastauksessa.
Palvelinpuolella. Yritä uudelleen viiveellä; jos ongelma jatkuu, lähetä pyynnön tunnus ratkaisujen asiantuntijalle.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Jos tarvitset tukea integraatioon, tunnistetietoihin tai myyntikanaviin liittyvissä kysymyksissä, räätälöityihin vaatimuksiin tai kapasiteetin suunnitteluun — ota yhteyttä tekniseen SE-kanavaan, älä myyntiosastoon. Vastaus yhden työpäivän kuluessa.
