01
Načítať zbierku
V programe Postman: File → Import → Link. Vložte URL súboru JSON z tlačidla na stiahnutie uvedené vyššie. Postman pridá túto zbierku – spolu s jej premennými – do vášho pracovného priestoru.
Vývojári · Zbierka Postman
Načítajte zbierku. Dosiahnite API za päť minút.
Predpripravená zbierka Postman s praktickými príkladmi pre integráciu Fabrixa s API. Stačí zadať svoje prihlasovacie údaje, prechádzať jednotlivé požiadavky a pozrieť si skutočné odpovede od API ešte predtým, ako napíšete jediný riadok integračného kódu. Zbierka je synchronizovaná s jednotlivými verziami – aktualizuje sa vždy, keď sa aktualizuje API.
Čo obsahuje táto zbierka
Každý koncový bod spolu s príkladmi dátových nákladov.
Usporiadané do zložiek podľa zdroja. Každá požiadavka obsahuje text s vyriešeným príkladom, dve vopred nastavené autentizačné hlavičky a uloženú ukážkovú odpoveď – vďaka čomu si môžete pred odoslaním požiadavky prezrieť, ako bude odpoveď vyzerať.
Autorizácia a produkty
- ZÍSKAŤ /ping — overiť prihlasovacie údaje
- ZÍSKAŤ /products — zoznam a stránkovanie (SKU + variant_id)
- Štruktúry celého poľa v referenčnom dokumente Swagger
Objednávky
- PRÍSPEVOK /orders — vytvoriť objednávku
- ZÍSKAŤ /orders/{id}/fulfillments — sledovanie výroby
Štúdio a webhooky
- ZÍSKAŤ /v2/studio/customizations/{key}/preview
- Obsah webhooku + overenie HMAC (príklad)
Import za 30 sekúnd
Súbor → Importovať → Prepojiť → vložiť URL.
02
Otvorte kartu „Premenné“
Kolekcia obsahuje vlastné premenné — base_url je vopred vyplnené; access_token a application_key sú zástupné znaky. Nie je potrebný žiadny samostatný súbor s nastaveniami prostredia.
03
Vložte svoje kľúče
Vložte prístupový token aplikácie a kľúč aplikácie z predajného kanála do svojho riadiaceho panela, kliknite na „Uložiť“ a každá žiadosť sa overí.
Premenné prostredia
Čo sa nachádza v súbore env.
Jedna základná URL adresa, dva prihlasovacie údaje, zabudované priamo do kolekcie. Vytvorte ju pre jeden predajný kanál a pri spustení do prevádzky jednoducho vložte kľúče vášho skutočného kanála – tá istá kolekcia, tie isté požiadavky.
Premenné kolekcie
{
"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"
}
Autentifikácia je vopred nakonfigurovaná
Obe autentizačné hlavičky sú prednastavené pri každej požiadavke.
Každá požiadavka obsahuje Authorization: Bearer {{access_token}} a X-Application-Key: {{application_key}}, načítané zo premenných kolekcie — bez nutnosti nastavovať hlavičku pre každú požiadavku. Prechod z jedného predajného kanála na druhý spočíva len v úprave týchto dvoch premenných: rovnaká kolekcia, odlišné kľúče.
Príklady s riešením
Každá požiadavka obsahuje ukážkové telo a uloženú odpoveď.
Táto zbierka neobsahuje len skrátené URL adresy – každá požiadavka obsahuje vypracovaný príklad tela požiadavky, takže stačí kliknúť na tlačidlo „Odoslať“ a uvidíte skutočné údaje. Uložené príklady odpovedí sa nachádzajú v paneli „Príklady“, kde sú k dispozícii aj v režime offline.
Overiť autorizáciu
Najskôr overí, či sú váš prístupový token aplikácie a kľúč aplikácie platné. V prípade úspechu vráti kód 200, v prípade chýbajúcej hlavičky kód 401.
Zoznam produktov
Žiadosť o katalóg s pagináciou. Vráti produkty po jednotlivých stránkach v obálke /meta/data, spolu s kódom SKU a identifikátorom variantu pre každú položku.
Vytvoriť objednávku
Ukážkový text pre objednávku jedného trička so zdrojovým súborom PDF, údajmi o zákazníkovi a dodacou adresou. Kliknutím na tlačidlo „Odoslať“ si môžete pozrieť vytvorenú objednávku s identifikačným číslom Fabrixa.
Sledovanie výroby
Na základe zadaných objednávok vygeneruje výrobné kroky pre jednotlivé položky (tlač, fixácia, pranie, šitie) so stavmi „čaká na spracovanie“, „v procese“, „hotové“ a „zamietnuté“.
Ukážka štúdia
Vráti vykreslený náhľad obrázku pre uložené prispôsobenie v programe Studio — stačí ho priamo vložiť do miniatúry v košíku.
Kontrola podpisu
Praktický príklad prepočítania podpisu HMAC-SHA256 a jeho porovnania s hodnotou x-webhook-signature pred spracovaním.
Verzovanie
Kolekcia sa aktualizuje súčasne s aktualizáciou API.
Každá verzia API obsahuje aktualizovanú zbierku na tej istej URL adrese. Vykonajte opätovný import, aby ste získali nové koncové body a ukážkové dáta – existujúce požiadavky vo vašej uloženej verzii budú naďalej fungovať, kým daný koncový bod nebude skutočne vyradený z používania.
Stála URL adresa
URL súboru JSON kolekcie je trvalá. Pri opätovnom importe sa načíta najnovšia verzia – táto URL sa medzi jednotlivými vydaniami nemení.
Prehľad zmien
Pozrite si zoznam zmien pre príslušné poznámky k verzii API – čo sa zmenilo, čo bolo pridané a čo sa prestáva používať.
Politika ukončenia podpory
Pre koncové body platí 12-mesačné prechodné obdobie. Zoznam označuje zastarané požiadavky v popise, takže je ťažké ich prehliadnuť skôr, ako dôjde k poruche.
Často kladené otázky
Kolekcia „Poštár“, odpovede
Ako môžem importovať zbierku Fabrixa v Postmane?
V aplikácii Postman vyberte možnosť „Súbor“, potom „Importovať“, následne „Odkaz“ a vložte URL súboru JSON zbierky. Postman pridá zbierku spolu s jej premennými do vášho pracovného priestoru – pole „base_url“ je už vyplnené, zatiaľ čo „access_token“ a „application_key“ sú zástupné symboly, ktoré nahradíte svojím vlastným prístupovým tokenom aplikácie a kľúčom aplikácie.
Aké koncové body sú zahrnuté v kolekcii Fabrixa v Postmane?
Táto zbierka obsahuje metódu GET /ping na overenie prihlasovacích údajov, metódu GET /products na zobrazenie zoznamu a stránkovanie katalógu, metódu POST /orders na vytvorenie objednávky, metódu GET /orders/{id}/fulfillments na sledovanie výroby, koncový bod na náhľad v aplikácii Studio a funkčný príklad overenia podpisu webhooku. Je vytvorená pre integráciu v2 API a vyžaduje Postman v10 alebo novšiu verziu.
Ako je nastavené overovanie v kolekcii Fabrixa pre Postman?
Každá požiadavka v kolekcii už obsahuje dve povinné hlavičky — Authorization: Bearer {{access_token}} a X-Application-Key: {{application_key}} — získané z premenných kolekcie. Vložením vášho prístupového tokenu aplikácie a kľúča aplikácie do týchto premenných sa overí každý požiadavka naraz, bez nutnosti nastavovania pre každú požiadavku zvlášť.
Aktualizuje sa kolekcia Fabrixa Postman, keď dôjde k zmene v API?
Áno — každá verzia API obsahuje aktualizovanú zbierku na tej istej trvalej URL adrese, takže pri opätovnom importe sa načítajú najnovšie koncové body a ukážkové dáta. Koncové body majú 12-mesačné prechodné obdobie, počas ktorého sa v popise zbierky označia zastarané požiadavky ešte predtým, ako dôjde k poruche.
Čo vráti požiadavka GET /orders/{id}/fulfillments?
Načíta stav výroby jednotlivých položiek v rámci zadaného objednávky, pričom zahŕňa kroky ako tlač, fixácia, pranie a šitie, pričom každý z nich je označený ako čakajúci, v procese, hotový alebo zamietnutý. Súbor Postman obsahuje praktický príklad, vďaka čomu je možné skontrolovať formát odpovede ešte pred jej zapojením do integrácie.
Stiahnuť a spustiť
Stiahnite si zbierku. Odoslite svoju prvú požiadavku.
Naimportujte kolekciu, zadajte prihlasovacie údaje k predajnému kanálu a za pár minút odošlite svoju prvú požiadavku – na začatie práce nepotrebujete žiadny integračný kód.