01
Uvezi kolekciju
U Postmanu: File → Import → Link. Zalijepite JSON URL s gornjeg gumba za preuzimanje. Postman dodaje kolekciju — sa svojim varijablama — u vaš radni prostor.
Programeri · Postman kolekcija
Uvezi kolekciju. Pritisni API za pet minuta.
Unaprijed pripremljena Postman kolekcija s radnim primjerima za Fabrixa integraciju API. Unesite svoje vjerodajnice, kliknite kroz zahtjeve i pogledajte stvarne odgovore na API prije nego što napišete ijedan red integracijskog koda. Prati se kroz verzije — kolekcija se ažurira kad se ažurira API.
Što se nalazi u kolekciji
Svaka završna točka, s primjerima korisnih tereta.
Organizirano u mape po resursu. Svaki zahtjev dolazi s tijelom obrađenog primjera, unaprijed postavljenim dvjema auth zaglavljima i spremljenim primjernim odgovorom — tako da možete pregledati oblik odgovora prije nego što ga pošaljete.
Autori i proizvodi
- DOBITI /ping — provjeri vjerodajnice
- DOBITI /products — popis i paginacija (SKU + variant_id)
- Sheme za cijelo polje u Swagger referenci
Narudžbe
- Objavi /orders — stvori narudžbu
- DOBITI /orders/{id}/fulfillments — praćenje proizvodnje
Studio i webhooks
- DOBITI /v2/studio/prilagodbe/{ključ}/pregled
- Pretovar webhooka + HMAC provjera (primjer)
Uvoz u 30 sekundi
Datoteka → Uvezi → Povežaj → zalijepi URL.
02
Otvorite karticu Varijable.
Kolekcija se isporučuje sa svojim vlastitim varijablama — base_url je unaprijed ispunjen; access_token i application_key To su mjesta držača. Nije potreban zaseban okvirni datotek.
03
Ulijepite svoje ključeve
Umetnite token za pristup aplikaciji i ključ aplikacije iz prodajnog kanala na svojoj nadzornoj ploči, pritisnite Spremi i svaki će se zahtjev autentificirati.
Promjenjive okruženja
Što je u datoteci env.
Jedna osnovna URL adresa, dva para vjerodajnica ugrađena u kolekciju. Izgradite za jedan prodajni kanal, a zatim zalijepite ključeve vašeg aktivnog kanala kad šaljete — ista kolekcija, ista pozivanja.
Varijable kolekcije
{
"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"
}
Auth unaprijed konfiguriran
Oba auth header-a, unaprijed postavljena na svakom zahtjevu.
Svaki zahtjev nosi Authorization: Bearer {{access_token}} i X-Application-Key: {{application_key}}, izvučeno iz varijabli kolekcije — nema postavljanja zaglavlja po zahtjevu. Prebacivanje s jednog prodajnog kanala na drugi svodi se na uređivanje tih dviju varijabli: ista kolekcija, različiti ključevi.
Primjeri s objašnjenjem
Svaki zahtjev dolazi s uzorkom tijela i spremljenim odgovorom.
Zbirka nije samo niz URL-ova — svaki zahtjev ima tijelo s obrađenim primjerom, pa možete kliknuti Pošalji i vidjeti stvarne podatke. Spremljeni primjeri odgovora nalaze se u panelu Primjeri za offline pregled.
Provjeri autentičnost
Prvo potvrđuje da su vaš token za pristup aplikaciji i ključ aplikacije valjani. 200 kod uspjeha, 401 ako nedostaje zaglavlje.
Popis proizvoda
Zahtjev za katalog s paginacijom. Vraća proizvode stranicu po stranici u poveznicama / meta / podatkovnoj omotnici, s SKU i ID-om varijante za svaki artikl.
Stvori narudžbu
Primjer sadržaja za narudžbu jedne majice s izvorom PDF-a, adresom kupca i adresom za dostavu. Kliknite Pošalji da biste vidjeli stvorenu narudžbu s njezinim Fabrixa ID-om.
Proizvodnja pjesama
Povlači proizvodne korake po artiklu (štampanje, popravak, pranje, šivanje) sa stanjima na čekanju, u tijeku, dovršeno i odbijeno za narudžbu.
Pregled studija
Vraća renderiranu pretpreglednu sliku spremljene Studio prilagodbe — ubacite je izravno u minijaturu košarice.
Provjera potpisa
Radni primjer ponovnog izračunavanja HMAC-SHA256 potpisa i usporedbe istog s x-webhook-signature prije obrade.
Verziranje
Kolekcija se ažurira kada se ažurira API.
Svako izdanje API-a dolazi s ažuriranom kolekcijom na istoj URL adresi. Ponovno uvezite zbirku kako biste preuzeli nove krajnje točke i primjere korisnih tereta — postojeći zahtjevi u vašoj spremljenoj verziji nastavljaju raditi sve dok ta krajnja točka zapravo ne bude zastarjela.
Stabilna URL adresa
URL za JSON kolekciju je trajan. Ponovni uvoz preuzima najnoviju verziju — URL se nikada ne mijenja između izdanja.
Referenca za zapis promjena
Pogledajte Zapisnik promjena za bilješke o odgovarajućoj verziji API — što je promijenjeno, što je dodano, što se ukida.
Politika amortizacije
Endpointima se dodjeljuje 12-mjesečni rok za povlačenje. Kolekcija označava zastarjele zahtjeve u opisu, pa ih je teško ne primijetiti prije nego što nešto zakaže.
Često postavljana pitanja
Odgovorena kolekcija poštara
Kako mogu uvesti kolekciju Fabrixa Postman?
U Postmanu odaberite Datoteka, zatim Uvezi, zatim Poveži i zalijepite JSON URL kolekcije. Postman dodaje kolekciju zajedno s njezinim varijablama u vaš radni prostor — base_url je unaprijed popunjen, dok su access_token i application_key mjesta držača koja zamjenjujete vlastitim tokenom za pristup aplikaciji i ključem aplikacije.
Koji krajnji točkovi su uključeni u Postman kolekciju Fabrixa?
Kolekcija obuhvaća GET /ping za provjeru vjerodajnica, GET /products za popisivanje i paginaciju kataloga, POST /orders za stvaranje narudžbe, GET /orders/{id}/fulfillments za praćenje proizvodnje, krajnju točku za pretpregled Studija i primjer provjere potpisa webhooka. Izgrađen je za v2 integraciju API i zahtijeva Postman v10 ili noviji.
Kako je autentifikacija postavljena u Postman kolekciji Fabrixa?
Svaki zahtjev u kolekciji već nosi dva obavezna zaglavlja — Authorization: Bearer {{access_token}} i X-Application-Key: {{application_key}} — preuzeta iz varijabli kolekcije. Ukopiranjem vašeg Application Access Tokena i Application Keyja u te varijable provodi se autentifikacija svakog zahtjeva odjednom, bez potrebe za postavkama za svaki pojedini zahtjev.
Ažurira li se kolekcija Fabrixa Postman kad se promijeni API?
Da — svako izdanje API-a dolazi s ažuriranom zbirkom na istoj trajnoj URL adresi, pa pri ponovnom uvozu preuzima najnovije krajnje točke i primjere korisnih tereta. Krajnje točke dobivaju 12-mjesečni rok za povlačenje iz upotrebe, a zbirka označava zastarjele zahtjeve u njihovim opisima prije nego što išta zakaže.
Što vraća GET zahtjev /orders/{id}/fulfillments?
Povlači status proizvodnje po stavci za narudžbu, obuhvaćajući korake poput tiska, popravka, pranja i šivanja, pri čemu se svaki izvještava kao u čeku, u tijeku, dovršeno ili odbijeno. Postmanova kolekcija uključuje obrađeni primjer kako bi se oblik odgovora mogao provjeriti prije nego što se integrira u integraciju.
Preuzmi i pokreni
Uzmite kolekciju. Pošaljite svoj prvi zahtjev.
Uvezi zbirku, unesi svoje podatke za prodajni kanal i pošalji svoj prvi upit u roku od nekoliko minuta — za početak istraživanja nije potreban nikakav integracijski kod.