01
Uvozi zbirko
V programu Postman: File → Import → Link. Prilepite URL v formatu JSON iz zgornjega gumba za prenos. Postman doda zbirko – skupaj z njenimi spremenljivkami – v vaš delovni prostor.
Razvijalci · Zbirka Postman
Uvozi zbirko. V petih minutah doseži API.
Vnaprej pripravljena zbirka Postman z delujočimi primeri za integracijo Fabrixa z API. Vnesite svoje prijavne podatke, klikajte po zahtevkih in si oglejte dejanske odgovore sistema API, še preden napišete eno samo vrstico integracijske kode. Sledenje spremembam med različicami – zbirka se posodablja ob posodobitvah sistema API.
Kaj vsebuje zbirka
Vsaka končna točka, skupaj s primeri vsebine.
Razvrščeno v mape po virih. Vsaka zahteva vsebuje besedilo z rešenim primerom, vnaprej nastavljena dva avtentifikacijska glava ter shranjen primer odgovora – tako si lahko pred pošiljanjem ogledate, kakšna bo oblika odgovora.
Avtorji in izdelki
- PRIDOBITI /ping — preveri poverilnice
- PRIDOBITI /products — seznam in razvrstitev po straneh (SKU + variant_id)
- Sheme celotnega polja v referenčnem dokumentu Swagger
Naročila
- OBJAVA /naročila — ustvari naročilo
- PRIDOBITI /orders/{id}/fulfillments — spremljanje proizvodnje
Studio in spletni kavlji
- PRIDOBITI /v2/studio/prilagoditve/{ključ}/predogled
- Vsebina webhooka + preverjanje HMAC (primer)
Uvoz v 30 sekundah
Datoteka → Uvoz → Povezava → vstavite URL.
02
Odpri zavihek »Spremenljivke«
Zbirka vsebuje svoje lastne spremenljivke — base_url je vnaprej izpolnjeno; access_token in application_key so zaznamki. Ločena datoteka z nastavitvami okolja ni potrebna.
03
Vstavi svoje ključe
Vnesite dostopni žeton in ključ aplikacije iz prodajnega kanala v nadzorno ploščo, kliknite »Shrani« in vsaka zahteva bo avtentificirana.
Okoljske spremenljivke
Kaj je v datoteki env?.
En osnovni URL, dva pristopna podatka, vgrajena v zbirko. Razvijte rešitev za en prodajni kanal, nato pa ob objavi vstavite ključe svojega dejanskega kanala – ista zbirka, iste zahteve.
Spremenljivke zbirke
{
"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"
}
Avtentifikacija je že nastavljena
Oba avtentifikacijska glava sta privzeto nastavljena pri vsakem zahtevku.
Vsaka zahteva vključuje Authorization: Bearer {{access_token}} in X-Application-Key: {{application_key}}, pridobljeni iz spremenljivk zbirke — ni potrebna nastavitev glave za vsako zahtevo posebej. Prehod z enega prodajnega kanala na drugega pomeni le urejanje teh dveh spremenljivk: ista zbirka, različni ključi.
Praktični primeri
Vsaka zahteva vsebuje vzorčno vsebino in shranjen odgovor.
Zbirka ne vsebuje le kratkih URL-jev – vsak zahtevek ima v telesu pripravljen primer, tako da lahko kliknete »Pošlji« in si ogledate dejanske podatke. Shranjeni primerni odgovori so na voljo v oknu »Primeri« za uporabo brez internetne povezave.
Preveri pristnost
Najprej preveri, ali sta vaš dostopni žeton aplikacije in ključ aplikacije veljavna. V primeru uspeha vrne kodo 200, v primeru manjkajočega glava pa kodo 401.
Seznam izdelkov
Zahteva za katalog s strani. V ovojnici /meta/data vrne izdelke po posameznih straneh, skupaj z identifikatorjem SKU in identifikatorjem variante za vsak izdelek.
Ustvari naročilo
Vzorec naročila za eno majico z izhodiščnim PDF-datotekom, podatki o stranki in naslovom za dostavo. Kliknite »Pošlji«, da si ogledate ustvarjeno naročilo z identifikacijsko številko Fabrixa.
Sledenje proizvodnji
Prikaže proizvodne korake po posameznem izdelku (tiskanje, fiksiranje, pranje, šivanje) z stanji »v čakanju«, »v izvedbi«, »zaključeno« in »zavrnjeno« za oddano naročilo.
Predogled studia
Vrne renderirano predogledno sliko za shranjeno prilagoditev v Studiu — jo lahko takoj vstavite kot miniaturno sliko v košarico.
Preverjanje podpisa
Praktični primer ponovnega izračuna podpisa HMAC-SHA256 in njegove primerjave s podpisom x-webhook-signature pred obdelavo.
Različice
Zbirka se posodobi, ko se posodobi API.
Vsaka nova različica API prinaša posodobljeno zbirko na istem URL-ju. Izvedite ponovni uvoz, da se vključijo nove končne točke in primerne vsebine – obstoječe zahteve v vaši shranjeni različici bodo še naprej delovale, dokler ta končna točka ne bo dejansko prenehala delovati.
Stabilni URL
URL zbirke JSON je nespremenljiv. Pri ponovnem uvozu se prenese najnovejša različica – URL se med posameznimi izdajami nikoli ne spremeni.
Sklic na seznam sprememb
Oglejte si seznam sprememb za ustrezne opombe k različici API – kaj se je spremenilo, kaj je bilo dodano, kaj se ne bo več uporabljalo.
Politika opuščanja
Za končne točke je predvideno 12-mesečno obdobje za opuščanje. Zbirka v opisu označi zahteve, ki se opuščajo, tako da jih je težko spregledati, preden pride do napak.
Pogosta vprašanja
Zbirka »Poštar«, odgovori
Kako uvozim zbirko Fabrixa v Postman?
V programu Postman izberite »Datoteka«, nato »Uvozi«, potem »Poveži« in prilepite JSON-URL zbirke. Postman doda zbirko skupaj z njenimi spremenljivkami v vaše delovno okolje – polje »base_url« je že izpolnjeno, medtem ko sta »access_token« in »application_key« nadomestna polja, ki ju nadomestite s svojim dostopnim žetonom aplikacije in ključem aplikacije.
Kateri končni točki so vključeni v zbirko Fabrixa v Postmanu?
Zbirka vključuje GET /ping za preverjanje poverilnic, GET /products za prikaz seznama in razvrščanje kataloga po straneh, POST /orders za ustvarjanje naročila, GET /orders/{id}/fulfillments za spremljanje proizvodnje, končno točko za predogled v Studiu ter delujoč primer preverjanja podpisa prek webhooka. Zbirka je zasnovana za integracijo v2 API in zahteva Postman v10 ali novejšo različico.
Kako je nastavljeno preverjanje pristnosti v zbirki Fabrixa Postman?
Vsako zahtevo v zbirki že vsebuje dva obvezna glava — Authorization: Bearer {{access_token}} in X-Application-Key: {{application_key}} — ki sta pridobljena iz spremenljivk zbirke. Z vstavitvijo vašega dostopnega žetona aplikacije in ključa aplikacije v te spremenljivke se vsak zahtevek avtentificira naenkrat, brez potrebe po nastavitvah za vsak posamezen zahtevek.
Ali se zbirka Fabrixa Postman posodobi, ko se spremeni API?
Da — vsaka nova različica API prinaša posodobljeno zbirko na istem stalnem URL-ju, zato se ob ponovnem uvozu prenesejo najnovejše končne točke in primerne vsebine. Končne točke imajo 12-mesečno obdobje za opuščanje, zbirka pa v opisu označi zastarele zahteve, še preden pride do kakršnih koli motenj.
Kaj vrne zahteva GET /orders/{id}/fulfillments?
Pridobi stanje proizvodnje po posameznih artiklih za oddano naročilo, ki zajema korake, kot so tiskanje, fiksiranje, pranje in šivanje, pri čemer je stanje vsakega od njih navedeno kot »v čakanju«, »v teku«, »zaključeno« ali »zavrnjeno«. Zbirka Postman vključuje praktičen primer, tako da je mogoče preveriti obliko odgovora, preden se ga vključi v integracijo.
Prenesi in začni
Pridobite zbirko. Pošljite svojo prvo zahtevo.
Uvozite zbirko, vnesite svoje prijavne podatke za prodajni kanal in v nekaj minutah pošljite svojo prvo zahtevo – za začetek raziskovanja ni potrebna nobena integracijska koda.