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 możesz sprawdzić, jak będzie wyglądała odpowiedź, zanim wyślesz żą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.
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.