01
Tuo kokoelma
Postmanissa: File → Import → Link. Liitä yllä olevan latauspainikkeen JSON-URL. Postman lisää kokoelman – muuttujineen – työtilaasi.
Kehittäjät · Postman-kokoelma
Tuo kokoelma. Viidessä minuutissa APIssa.
Valmiiksi koottu Postman-kokoelma, joka sisältää käytännön esimerkkejä Fabrixa Integration API:sta. Syötä tunnuksesi, selaa pyyntöjä ja katso todellisia vastauksia API:ltä ennen kuin kirjoitat yhtään riviä integraatiokoodia. Versioita seurataan – kokoelma päivittyy, kun API päivittyy.
Mitä kokoelma sisältää
Jokainen endpoint, mukana esimerkkipayloadit.
Järjestetty kansioihin resurssin mukaan. Jokainen pyyntö sisältää valmiin esimerkkipyynnön, kaksi valmiiksi asetettua todennusotsikkoa sekä tallennetun esimerkkivastauksen – näin voit tarkastella vastauksen rakennetta etukäteen ennen pyynnön lähettämistä.
Autentikointi ja tuotteet
- GET /ping — tunnistetietojen tarkistaminen
- GET /products — luettelo ja sivutus (SKU + variant_id)
- Swagger-viitteessä olevat täysimittaiset kenttäkaaviot
Tilaukset
- POST /orders — luo tilaus
- GET /orders/{id}/fulfillments — tuotannon seuranta
Studio ja webhookit
- GET /v2/studio/customizations/{key}/preview
- Webhook-payload + HMAC-todennus (esimerkki)
Tuo tiedosto 30 sekunnissa
Tiedosto → Tuo → Linkki → liitä URL-osoite.
02
Avaa Muuttujat-välilehti
Kokoelmaan kuuluu omat muuttujansa — base_url on esitäytetty; access_token ja application_key ovat paikkamerkkejä. Erillistä ympäristötiedostoa ei tarvita.
03
Liitä avaimesi
Syötä hallintapaneelissasi myyntikanavan sovelluksen pääsytunnus ja sovelluksen avain, paina Tallenna, ja jokainen pyyntö todennetaan.
Ympäristömuuttujat
Mitä env-tiedosto sisältää.
Yksi perus-URL ja kaksi tunnistetietoa, jotka on sisällytetty kokoelmaan. Kehitä sovellus yhtä myyntikanavaa varten ja liitä sitten tuotantoympäristön avaimet julkaisun yhteydessä — sama kokoelma, samat pyynnöt.
Kokoelman muuttujat
{
"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"
}
Todennus on esiasetettu
Molemmat todennusotsikot, jotka on määritetty valmiiksi jokaisessa pyynnössä.
Jokaiseen pyyntöön liittyy Authorization: Bearer {{access_token}} ja X-Application-Key: {{application_key}}, jotka haetaan kokoelman muuttujista — pyyntökohtaista otsikkokonfiguraatiota ei tarvita. Siirtyminen yhdestä myyntikanavasta toiseen tapahtuu yksinkertaisesti muokkaamalla näitä kahta muuttujaa: sama kokoelma, eri avaimet.
Esimerkkejä ratkaisuineen
Jokaiseen pyyntöön sisältyy esimerkki pyyntötekstistä ja tallennettu vastaus.
Kokoelma ei koostu pelkästään URL-lyhenteistä — jokaisella pyynnöllä on valmis esimerkkiteksti, joten voit painaa Lähetä-painiketta ja nähdä todellisia tietoja. Tallennetut esimerkkivastaukset löytyvät Esimerkit-paneelista, josta niitä voi tarkastella myös offline-tilassa.
Vahvista tunnistautuminen
Varmistaa ensimmäisenä, että sovelluksen pääsytunnus ja sovellusavain ovat voimassa. Palauttaa koodin 200, jos pyyntö onnistuu, ja koodin 401, jos jokin otsikko puuttuu.
Luettele tuotteet
Sivutettu tuoteluettelopyyntö. Palauttaa tuotteet sivu kerrallaan links/meta/data-kääreessä, sisältäen jokaiselle tuotteelle SKU-tunnuksen ja varianttitunnuksen.
Tee tilaus
Esimerkki yhden kappaleen T-paita-tilauksesta, jossa on lähde-PDF, asiakkaan tiedot ja toimitusosoite. Napsauta Lähetä-painiketta nähdäksesi luodun tilauksen ja sen Fabrixa-tunnuksen.
Tuotannon seuranta
Näyttää tilatun tilauksen tuotantovaiheet tuotekohtaisesti (tulostus, kiinnitys, pesu, ompelu) sekä niiden tilat: odottava, käynnissä, valmis ja hylätty.
Studion esikatselu
Palauttaa tallennetun Studio-mukautuksen renderoidun esikatselukuvan — voit lisätä sen suoraan ostoskorin pikkukuvaan.
Allekirjoituksen tarkistus
Esimerkki HMAC-SHA256-allekirjoituksen uudelleenlaskemisesta ja sen vertaamisesta x-webhook-signature-arvoon ennen käsittelyä.
Versiointi
Kokoelma päivittyy samaan aikaan kuin API.
Jokaisen API-julkaisun yhteydessä päivitetyn kokoelman voi ladata samasta URL-osoitteesta. Tuo kokoelma uudelleen, jotta saat käyttöön uudet päätepisteet ja esimerkkipayloadit — tallennetussa versiossasi olevat olemassa olevat pyynnöt toimivat edelleen, kunnes kyseinen päätepiste poistuu käytöstä.
Vakaa URL-osoite
JSON-kokoelman URL-osoite on pysyvä. Uudelleentuonti hakee uusimman version — URL-osoite ei muutu julkaisujen välillä.
Changelog
Katso muutosloki katso vastaavat API-version muistiinpanot — mitä on muutettu, mitä on lisätty ja mitkä ominaisuudet ovat poistumassa käytöstä.
Vanhentamiskäytäntö
Endpointeille myönnetään 12 kuukauden siirtymäaika. Kokoelma merkitsee vanhentuneet pyynnöt kuvaukseen, joten niitä on vaikea jättää huomaamatta ennen kuin järjestelmässä ilmenee vikoja.
Lataa ja aloita
Hanki kokoelma. Lähetä ensimmäinen pyyntösi.
Tuo kokoelma, syötä myyntikanavan tunnukset ja lähetä ensimmäinen pyyntösi muutamassa minuutissa — tutustumisen aloittamiseen ei tarvita integrointikoodia.