01
Zaimportuj kolekcję
W aplikacji Postman: File → Import → Link. Wklej adres URL pliku JSON z przycisku pobierania powyżej. Postman doda kolekcję — wraz ze zmiennymi — do Państwa workspace'u.
Programiści · Kolekcja Postman
Zaimportuj kolekcję. Pięć minut i działasz na API.
Gotowa kolekcja Postman z praktycznymi przykładami dla Fabrixa Integration API. Wystarczy wprowadzić swoje dane uwierzytelniające, przejrzeć żądania i sprawdzić rzeczywiste odpowiedzi serwisu API, zanim napiszesz choćby jedną linię kodu integracyjnego. Kolekcja jest aktualizowana wraz ze zmianami w API — śledzimy zmiany we wszystkich wersjach.
Co zawiera ta kolekcja
Każdy endpoint wraz z przykładowymi payloadami.
Zgrupowane w folderach według zasobów. Każde żądanie zawiera gotowy przykład treści, dwa wstępnie skonfigurowane nagłówki autoryzacyjne oraz zapisany przykład odpowiedzi — dzięki czemu mogą Państwo sprawdzić, jak będzie wyglądała odpowiedź, zanim wyślą Państwo żądanie.
Autoryzacja i produkty
- GET /ping — weryfikacja danych uwierzytelniających
- GET /products — lista i paginacja (SKU + variant_id)
- Pełne schematy pól w dokumentacji Swagger
Zamówienia
- POST /orders — utworzenie zamówienia
- GET /orders/{id}/fulfillments — śledzenie produkcji
Studio i webhooki
- GET /v2/studio/customizations/{key}/preview
- Payload webhooka + weryfikacja HMAC (przykład)
Import w 30 sekund
Plik → Importuj → Połącz → wklej adres URL.
02
Otwórz kartę „Zmienne”
Kolekcja zawiera własne zmienne — base_url jest wstępnie wypełnione; access_token oraz application_key są symbolami zastępczymi. Nie jest potrzebny oddzielny plik środowiskowy.
03
Wklej swoje klucze
Wprowadź token dostępu do aplikacji oraz klucz aplikacji z kanału sprzedaży w swoim panelu, kliknij „Zapisz”, a każde żądanie zostanie uwierzytelnione.
Zmienne środowiskowe
Co zawiera plik env.
Jeden bazowy adres URL, dwa zestawy danych uwierzytelniających, wbudowane w kolekcję. Stwórz aplikację pod kątem jednego kanału sprzedaży, a następnie w momencie uruchomienia wklej klucze swojego rzeczywistego kanału — ta sama kolekcja, te same żądania.
Zmienne kolekcji
{
"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"
}
Uwierzytelnianie wstępnie skonfigurowane
Oba nagłówki uwierzytelniające są domyślnie ustawiane w każdym żądaniu.
Każde żądanie zawiera Authorization: Bearer {{access_token}} oraz X-Application-Key: {{application_key}}, pobierane ze zmiennych kolekcji — bez konieczności konfigurowania nagłówków dla każdego żądania. Przejście z jednego kanału sprzedaży na inny polega po prostu na edycji tych dwóch zmiennych: ta sama kolekcja, inne klucze.
Gotowe przykłady
Każde żądanie zawiera przykładową treść oraz zapisaną odpowiedź.
Kolekcja to nie tylko puste adresy URL — każde żądanie zawiera gotowy przykład treści, dzięki czemu wystarczy kliknąć „Wyślij”, aby zobaczyć rzeczywiste dane. Zapisane przykładowe odpowiedzi są dostępne w panelu „Przykłady” i można z nich korzystać w trybie offline.
Sprawdź uwierzytelnienie
Przede wszystkim sprawdza, czy token dostępu aplikacji i klucz aplikacji są prawidłowe. Zwraca kod 200 w przypadku powodzenia, a 401, jeśli brakuje nagłówka.
Wyświetl produkty
Zapytanie o katalog z paginacją. Zwraca produkty strona po stronie w kopercie links / meta / data, wraz z identyfikatorem SKU i identyfikatorem wariantu dla każdej pozycji.
Złóż zamówienie
Przykładowa treść zamówienia na jedną sztukę koszulki wraz z plikiem PDF źródłowym, danymi klienta i adresem wysyłki. Naciśnij „Wyślij”, aby wyświetlić utworzone zamówienie o identyfikatorze Fabrixa.
Śledzenie produkcji
Wyświetla etapy produkcji poszczególnych pozycji (drukowanie, utrwalanie, pranie, szycie) wraz ze statusami: oczekujące / w toku / zakończone / odrzucone dla złożonego zamówienia.
Podgląd Fabrixa Studio
Zwraca wyrenderowany obraz podglądu dla zapisanej personalizacji w Studio — można go od razu umieścić jako miniaturkę w koszyku.
Weryfikacja podpisu
Przykład praktyczny pokazujący ponowne obliczenie podpisu HMAC-SHA256 i porównanie go z wartością x-webhook-signature przed przetworzeniem.
Wersjonowanie
Kolekcja jest aktualizowana wraz z aktualizacją API.
Każda wersja API zawiera zaktualizowany zbiór dostępny pod tym samym adresem URL. Należy ponownie zaimportować dane, aby uwzględnić nowe punkty końcowe i przykładowe dane — istniejące żądania w zapisanej wersji będą nadal działać, dopóki dany punkt końcowy nie zostanie faktycznie wycofany.
Stały adres URL
Adres URL pliku JSON z kolekcją jest stały. Ponowne zaimportowanie powoduje pobranie najnowszej wersji — adres URL nie zmienia się między kolejnymi wydaniami.
Changelog — dokumentacja
Zobacz Changelog aby poznać zmiany w danej wersji API — co się przeniosło, co doszło, a co jest wycofywane.
Polityka wycofywania funkcji
Endpointy mają 12-miesięczne okno wycofywania. W opisie zbioru zaznaczono przestarzałe żądania, dzięki czemu trudno je przeoczyć, zanim dojdzie do jakichkolwiek problemów.
Najczęściej zadawane pytania
Kolekcja „Listonosz” – odpowiedzi
Jak zaimportować kolekcję Fabrixa z Postmana?
W aplikacji Postman proszę wybrać opcję „Plik”, następnie „Importuj”, a potem „Link” i wkleić adres URL pliku JSON kolekcji. Postman doda kolekcję wraz z jej zmiennymi do Państwa obszaru roboczego — pole „base_url” jest już wypełnione, natomiast pola „access_token” i „application_key” to symbole zastępcze, które należy zastąpić własnym tokenem dostępu do aplikacji i kluczem aplikacji.
Jakie punkty końcowe znajdują się w kolekcji Fabrixa w Postmanie?
Zbiór obejmuje żądanie GET /ping do weryfikacji poświadczeń, żądanie GET /products do wyświetlenia listy produktów i paginacji katalogu, żądanie POST /orders do utworzenia zamówienia, żądanie GET /orders/{id}/fulfillments do śledzenia realizacji zamówienia, punkt końcowy podglądu Studio oraz gotowy przykład weryfikacji podpisu webhooka. Została stworzona dla integracji v2 API i wymaga Postmana w wersji 10 lub nowszej.
W jaki sposób skonfigurowano uwierzytelnianie w kolekcji Fabrixa w Postmanie?
Każde żądanie w kolekcji zawiera już dwa wymagane nagłówki — Authorization: Bearer {{access_token}} oraz X-Application-Key: {{application_key}} — pobrane ze zmiennych kolekcji. Wklejenie tokenu dostępu aplikacji i klucza aplikacji do tych zmiennych powoduje jednorazowe uwierzytelnienie każdego żądania, bez konieczności konfigurowania każdego żądania z osobna.
Czy kolekcja „Fabrixa Postman” aktualizuje się, gdy zmienia się wersja API?
Tak — każda wersja API zawiera zaktualizowany zbiór dostępny pod tym samym stałym adresem URL, więc ponowne zaimportowanie powoduje pobranie najnowszych punktów końcowych i przykładowych danych. Punkty końcowe mają 12-miesięczny okres wycofywania, a zbiór zaznacza w opisie wycofane żądania, zanim dojdzie do jakichkolwiek problemów.
Co zwraca żądanie GET /orders/{id}/fulfillments?
Pobiera status produkcji poszczególnych pozycji w złożonym zamówieniu, obejmujący etapy takie jak drukowanie, naprawa, pranie i szycie, z których każdy jest oznaczony jako oczekujący, w trakcie realizacji, zakończony lub odrzucony. Zbiór Postman zawiera przykładowe rozwiązanie, dzięki czemu można sprawdzić format odpowiedzi przed włączeniem go do integracji.
Pobierz i uruchom
Pobierz kolekcję. Wyślij pierwsze żądanie.
Zaimportuj kolekcję, wprowadź dane uwierzytelniające swojego kanału sprzedaży i wyślij pierwsze zapytanie w ciągu kilku minut — nie potrzebujesz żadnego kodu integracyjnego, aby rozpocząć korzystanie z platformy.