Każdy release API. Każdy breaking change. Zapisany.
Fabrixa udostępnia aktualizacje API oraz platformy w przewidywalnych odstępach czasu. Każda aktualizacja pojawia się najpierw tutaj — co się zmieniło, jakie są nowości, co zostanie wycofane i kiedy faktycznie przestanie działać. Przed aktualizacją sprawdź tę stronę.
Co się zmieniło w ciągu ostatnich kilku tygodni.
Najnowsze wpisy na początku. Każdy wpis jest opatrzony datą, oznaczony tagiem zgodnym z semver oraz podzielony na standardowe kategorie: Dodano / Zmieniono / Wycofano / Usunięto / Naprawiono / Bezpieczeństwo.
- CHANGEDNajświeższe wiadomości: ścieżka bazowa została przeniesiona do
/v2/integration. Punkty końcowe w wersji v1 zostały wycofane — istniejące integracje oparte na wersji v1 będą nadal działać w okresie wycofywania; zobacz przewodnik po integracji. - CHANGEDNajświeższe wiadomości: uwierzytelnianie składa się teraz z dwóch nagłówków —
Authorization: Bearer(Token dostępu do aplikacji) orazX-Application-Key. Uwierzytelnianie typu „single-token v1” nie jest już akceptowane. - ADDEDFabrixa Studio — narzędzie do personalizacji produktów typu „white label” z możliwością osadzenia: osadź za pomocą iframe, dołącz zapisany projekt do wiersza zamówienia za pomocą
cart_item_key, a podgląd można pobrać z/v2/studio/customizations/{key}/preview. - CHANGEDStandardowa odpowiedź dotycząca punktów końcowych listy:
links/meta/dataz linkami do kolejnych stron. - CHANGEDWebhooki skonsolidowane w
order.createdorazorder.updated, podpisane zx-webhook-signature(HMAC-SHA256) oraz oznaczone tagiemx-webhook-topic. - CHANGEDLimit żądań ustalono na 30 żądań na aplikację na minutę; informacja ta jest wyświetlana za pośrednictwem
X-RateLimit-LimitorazX-RateLimit-Remainingnagłówki.
- ADDED
GET /v1/products/:id/pricing— podgląd cen jednostkowych w poszczególnych przedziałach wielkości sprzedaży w jednostkach SKU. - CHANGEDTreść webhooka zamówienia zawiera teraz
production_hubpole (PT, ES lub NL). Zapewnia kompatybilność wsteczną.
- ADDEDPięciostopniowy proces personalizacji pościeli, bielizny stołowej i akcesoriów: tekst, imię i nazwisko, liczby, obrazy oraz dynamiczne pola danych.
- ADDED
order.failedzdarzenie typu webhook zawierające ustrukturyzowane przyczyny błędów (odrzucenie grafiki, brak materiału w magazynie i tym podobne). - FIXEDSzczególny przypadek paginacji w
GET /v1/orderspodczas filtrowania według statusu z uwzględnieniem kolejnych stron.
- ADDEDPoduszka ogrodowa, obrus i worek do siedzenia SKUs przeznaczone do użytku na zewnątrz, wykonane z materiałów syntetycznych. Dostępne za pośrednictwem
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64pole w treści zamówienia — zamiast tego podaj adres URL pliku źródłowego. Termin usunięcia: v1.20.0 (28.03.2027). - SECURITYWzmocniono schemat podpisywania webhooków. Poprzedni wariant HMAC pozostaje ważny do wersji v1.18.0; od tej wersji nowy sposób podpisywania będzie stosowany automatycznie.
- ADDEDKategoria pościeli (poszwy na kołdry 1P / 2P / Lits Jumeaux, narzuty na łóżka, prześcieradła z gumką) w hiszpańskim centrum.
- ADDEDSerwetka z nadrukiem sublimacyjnym SKUs w centrum dystrybucyjnym w Holandii z gwarantowanym czasem dostawy wynoszącym 2–3 dni robocze.
- CHANGEDPunkt końcowy zamówienia akceptuje teraz
recipient.countryjako ISO 3166-1 alpha-2; rezerwowa wersja alpha-3 została usunięta.
Starsze wersje dostępne na życzenie — prosimy o kontakt mailowy developers@fabrixa.com.
SemVer z ostrożnymi zmianami powodującymi niekompatybilność.
Zmiany powodujące niekompatybilność z istniejącymi punktami końcowymi
Rzadkość. Ogłoszenie następuje 12 miesięcy przed premierą. Poparcie dla starej wersji głównej jest zapewniane przez 12 miesięcy po wprowadzeniu nowej wersji głównej. Nie rezygnujemy z głównych wersji bez ważnego powodu.
Nowe punkty końcowe, pola, zachowanie
Dodatki zapewniające kompatybilność wsteczną. Dotychczasowy kod nadal działa bez zmian. Większość wydań to aktualizacje pomniejsze, pojawiające się mniej więcej co dwa do czterech tygodni.
Poprawki błędów, wydajność, bezpieczeństwo
Zmiany nie powodują żadnych błędów. Wdrażane na bieżąco bez wcześniejszego ogłoszenia, a informacje o nich są zapisywane w dzienniku zmian po wdrożeniu.
12 miesięcy od ogłoszenia o wycofaniu funkcji do jej usunięcia.
Kiedy oznaczamy pole, punkt końcowy lub zachowanie jako przestarzałe, wpis w dzienniku zmian jest odpowiednio oznaczany DEPRECATED oraz podaje wersję docelową i datę wycofania. Wycofana funkcja będzie nadal działać przez co najmniej 12 miesięcy od daty ogłoszenia.
Wysyłamy trzy powiadomienia przypominające — sześć miesięcy, trzy miesiące i jeden miesiąc przed usunięciem — na adres e-mail podany w danych klucza API.
Wycofane punkty końcowe również zwracają X-Fabrixa-Deprecation nagłówek odpowiedzi wskazujący ścieżkę migracji, dzięki czemu będzie on widoczny w logach.
Jak śledzić zmiany.
Nie trzeba podłączać żadnych kanałów — ta strona jest wiarygodnym źródłem informacji. Oto jak być na bieżąco ze wszystkim, co ma wpływ na Twoją integrację.
Najpierw sprawdź tutaj
Na tej stronie pojawiają się wszystkie wydania, przy czym najnowsze znajdują się na górze. Dodaj ją do zakładek i przejrzyj przed aktualizacją zależności lub wdrożeniem nowej integracji.
Czysty pas startowy
Gdy coś jest wycofywane, jego wpis jest oznaczany DEPRECATED wraz z docelową wersją i datą usunięcia — z wyprzedzeniem, w odpowiednim kontekście.
Zapytaj o zmianę
Planujesz wprowadzenie zmian lub migrację do nowej wersji głównej? Inżynier ds. rozwiązań może omówić z Państwem harmonogram i skutki Państwa integracji.
Kiedy można wprowadzać zmiany powodujące niekompatybilność.
Wprowadzanie nowych wersji głównych jest planowane w określonych przedziałach czasowych, tak aby nie zbiegało się z terminami dostaw dla klientów ani szczytowymi okresami sprzedaży detalicznej. W większości lat nie wprowadza się żadnych nowych wersji głównych.
Luty i wrzesień to typowe okresy wprowadzania zmian przełomowych — oba przypadają po zakończeniu głównego sezonu sprzedaży detalicznej i przed okresem szczytowym, co daje integratorom czas na przeprowadzenie migracji przed kolejnym dużym spadkiem sprzedaży.
Listopad–grudzień (okres świąteczny), marzec–maj (targi Fespa i wiosenne premiery) oraz dwa tygodnie poprzedzające znane wydarzenia branżowe to okresy, w których nie wprowadza się zmian przełomowych. Nadal publikowane są aktualizacje poprawkowe, ale nie wprowadzane są żadne drobne ani znaczące zmiany w działaniu oprogramowania.
Dział inżynierii rozwiązań pomaga integratorom pokonywać największe trudności.
W przypadku przejścia na nową wersję główną publikujemy przewodnik po migracji wraz z informacjami o wydaniu. Zespół ds. rozwiązań technicznych organizuje również bezpłatne 30-minutowe konsultacje dotyczące migracji dla wszystkich aktywnych partnerów integracyjnych w okresie wycofywania starej wersji — rezerwacji można dokonać za pośrednictwem strony „contact-engineer”. Klienci korporacyjni otrzymują dedykowane wsparcie w zakresie migracji w ramach umowy MSA, a także wczesny dostęp do nowej głównej wersji w testowym kanale sprzedaży na 90 dni przed jej publiczną dostępnością.
Przed aktualizacją sprawdź to tutaj.
Każda nowa wersja pojawia się najpierw tutaj — co się zmieniło i kiedy może wystąpić błąd. Wycofywane funkcje mają okres przejściowy, a przy zmianach wersji głównej zapewniamy wsparcie przy migracji.