Vývojáři · Sbírka Postman

Načtěte sbírku. Dosáhněte skóre API za pět minut.

Předem připravená kolekce Postman s praktickými příklady pro integraci Fabrixa s API. Stačí zadat své přihlašovací údaje, procházet jednotlivé požadavky a prohlédnout si skutečné odpovědi od API ještě předtím, než napíšete jediný řádek integračního kódu. Sledování napříč verzemi – kolekce se aktualizuje vždy, když dojde k aktualizaci API.

Stáhnout sbírku → Přečtěte si průvodce integrací

Postman v10+ · Ověřování pomocí dvou hlaviček · Integrace v2 API

Co obsahuje sbírka

Všechny koncové body s příklady datových nákladů.

Uspořádáno do složek podle zdroje. Každý požadavek obsahuje tělo s vypracovaným příkladem, přednastavené dvě autorizační hlavičky a uloženou ukázkovou odpověď – takže si můžete před odesláním prohlédnout, jak bude odpověď vypadat.

Autorizace a produkty

ZÍSKAT /ping — ověřit přihlašovací údaje
ZÍSKAT /products — seznam a stránkování (SKU + variant_id)
Schéma celého pole v referenční dokumentaci Swaggeru

Objednávky

PŘÍSPĚVEK /orders — vytvořit objednávku
ZÍSKAT /orders/{id}/fulfillments — sledování výroby

Studio a webhooky

ZÍSKAT /v2/studio/customizations/{key}/preview
Obsah webhooku + ověření HMAC (příklad)

Import za 30 sekund

Soubor → Importovat → Propojit → vložit URL.

Načíst sbírku

V aplikaci Postman: File → Import → Link. Vložte adresu URL souboru JSON z tlačítka pro stažení výše. Postman přidá tuto kolekci – včetně jejích proměnných – do vašeho pracovního prostoru.

Otevřete kartu „Proměnné“

Tato kolekce obsahuje vlastní proměnné — base_url je předvyplněno; access_token a application_key jsou zástupné symboly. Není třeba žádný samostatný soubor s nastavením prostředí.

Vložte své klíče

Zadejte přístupový token aplikace a klíč aplikace z prodejního kanálu ve vašem řídicím panelu, klikněte na „Uložit“ a každý požadavek bude ověřen.

Proměnné prostředí

Co obsahuje soubor env.

Jedna základní URL adresa, dva přihlašovací údaje, zabudované přímo do kolekce. Vytvořte aplikaci pro jeden prodejní kanál a při nasazení vložte klíče svého ostrého kanálu – stejná kolekce, stejné požadavky.

Proměnné kolekce

{
  "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"
}

Ověřování je předem nakonfigurováno

Obě autentizační hlavičky jsou přednastaveny u každého požadavku.

Každý požadavek obsahuje Authorization: Bearer {{access_token}} a X-Application-Key: {{application_key}}, načtené z proměnných kolekce — není třeba nastavovat hlavičky pro každý jednotlivý požadavek. Přepnutí z jednoho prodejního kanálu na druhý spočívá pouze v úpravě těchto dvou proměnných: stejná kolekce, jiné klíče.

Praktické příklady

Každý požadavek obsahuje ukázkové tělo a uloženou odpověď.

Tato sbírka neobsahuje pouze zkrácené URL adresy – každý požadavek obsahuje propracované tělo příkladu, takže stačí kliknout na „Odeslat“ a zobrazí se vám skutečná data. Uložené příklady odpovědí najdete v panelu „Příklady“, kde jsou k dispozici i pro offline použití.

GET /ping

Ověřit autorizaci

Nejprve ověří, zda jsou váš přístupový token aplikace a klíč aplikace platné. V případě úspěchu vrátí kód 200, v případě chybějícího záhlaví kód 401.

GET /products

Zobrazit produkty

Žádost o katalog s paginací. Vrací produkty po jednotlivých stránkách v obálce /meta/data, s kódem SKU a identifikátorem varianty pro každou položku.

POST /orders

Vytvořit objednávku

Ukázkový text pro objednávku jednoho kusu trička s výchozím souborem PDF, údaji o zákazníkovi a doručovací adresou. Kliknutím na tlačítko „Odeslat“ si můžete prohlédnout vytvořenou objednávku s identifikačním číslem Fabrixa.

GET /orders/{id}/fulfillments

Sledování výroby

Zobrazuje jednotlivé výrobní kroky pro každou položku (tisk, fixace, praní, šití) s údaji o stavu (čeká na zpracování / v procesu / hotovo / zamítnuto) pro zadanou objednávku.

/studio/.../náhled

Náhled studia

Vrátí vykreslený náhledový obrázek pro uloženou úpravu ve Studiu – stačí jej vložit přímo do miniatury v košíku.

Ověření webhooku

Ověření podpisu

Praktický příklad přepočítání podpisu HMAC-SHA256 a jeho porovnání s hodnotou x-webhook-signature před zpracováním.

Verzování

Kolekce se aktualizuje současně s aktualizací API.

Každá nová verze API obsahuje aktualizovanou sbírku na stejné URL adrese. Pro načtení nových koncových bodů a ukázkových datových nákladů proveďte opětovný import – stávající požadavky ve vaší uložené verzi budou fungovat, dokud daný koncový bod nebude skutečně vyřazen z provozu.

Stabilní URL adresa

URL souboru JSON sbírky je trvalá. Při opětovném importu se načte nejnovější verze – URL se mezi jednotlivými vydáním nemění.

Přehled změn

Podívejte se na seznam změn pro související poznámky k verzi API – co se změnilo, co bylo přidáno a co se stává zastaralým.

Zásady týkající se zastaralých funkcí

Pro koncové body je stanoveno 12měsíční přechodné období. Sbírka v popisu označuje zastaralé požadavky, takže je těžké je přehlédnout, než dojde k poruše.

Často kladené otázky

Kolekce „Pošťák“ – odpovědi

Jak mohu importovat sbírku Fabrixa z aplikace Postman?

V aplikaci Postman vyberte možnost „Soubor“, poté „Importovat“ a následně „Odkaz“ a vložte URL souboru JSON sbírky. Postman přidá sbírku spolu s jejími proměnnými do vašeho pracovního prostoru – pole „base_url“ je již vyplněno, zatímco „access_token“ a „application_key“ jsou zástupné symboly, které nahraďte svým vlastním přístupovým tokenem aplikace a klíčem aplikace.

Jaké koncové body jsou součástí kolekce Fabrixa v Postmanu?

Tato kolekce zahrnuje metodu GET /ping pro ověření přihlašovacích údajů, metodu GET /products pro zobrazení seznamu a stránkování katalogu, metodu POST /orders pro vytvoření objednávky, metodu GET /orders/{id}/fulfillments pro sledování výroby, koncový bod pro náhled ve Studiu a funkční příklad ověření podpisu webhooku. Je vytvořena pro integraci v2 API a vyžaduje Postman v10 nebo novější.

Jak je nastaveno ověřování v kolekci Fabrixa pro Postman?

Každý požadavek v kolekci již obsahuje dvě povinné hlavičky — Authorization: Bearer {{access_token}} a X-Application-Key: {{application_key}} — načtené z proměnných kolekce. Vložením vašeho přístupového tokenu aplikace a klíče aplikace do těchto proměnných se každý požadavek ověří najednou, aniž by bylo nutné provádět nastavení pro každý požadavek zvlášť.

Aktualizuje se kolekce Fabrixa Postman, když dojde ke změně v API?

Ano – každá verze API obsahuje aktualizovanou sbírku na stejné trvalé URL adrese, takže při opětovném importu se načtou nejnovější koncové body a ukázkové datové nálože. Koncové body mají 12měsíční přechodné období, během něhož jsou zastaralé požadavky ve sbírce označeny v popisu ještě předtím, než dojde k jakýmkoli poruchám.

Co vrátí požadavek GET /orders/{id}/fulfillments?

Načte stav výroby jednotlivých položek v rámci zadané objednávky, a to včetně fází jako tisk, fixace, praní a šití, přičemž stav každé z nich je vyznačen jako čekající, v procesu, hotovo nebo zamítnuto. Součástí kolekce Postman je praktický příklad, díky kterému lze ověřit formát odpovědi ještě předtím, než bude zapojen do integrace.

Stáhnout a spustit

Stáhněte si sbírku. Odeslání prvního dotazu.

Načtěte kolekci, zadejte přihlašovací údaje pro svůj prodejní kanál a odešlete svůj první požadavek během několika minut – k tomu, abyste mohli začít kolekci prozkoumávat, není potřeba žádný integrační kód.

Stáhnout sbírku Přečtěte si průvodce integrací