Z tego przewodnika dowiesz się, jak interfejs Merchant API obsługuje wersjonowanie, wersje i cykl życia różnych wersji.
Schemat obsługi wersji
Interfejs Merchant API stosuje strategię wersji na poziomie podrzędnego interfejsu API. Oznacza to, że poszczególne komponenty lub usługi w Merchant API będą miały własny cykl życia wersji.
Wersje formatu i prezentacji
Stabilne wersje podrzędnych interfejsów API: jeśli podrzędny interfejs API jest w wersji stabilnej, wszystkie jego metody są w wersji stabilnej. Stabilna wersja pod-API jest reprezentowana jako vX (np. v1, v2). Są to wersje główne gotowe do wdrożenia.
Wersje podrzędnego interfejsu API w wersji alfa: jeśli podrzędny interfejs API jest w wersji alfa, wszystkie jego metody są w wersji alfa. Wersja alfa podinterfejsu API jest reprezentowana jako vXalpha (np. v1alpha, v2alpha). Są to wersje eksperymentalne, przeznaczone do testowania i szybkiego ulepszania. Wersje alfa nie są stabilne i nie mają określonego okresu ważności. Wersje alfa można zmienić lub wycofać z 30-dniowym wyprzedzeniem.
Zmiany wersji
Duże aktualizacje wersji (np. z 1 na 2): sygnalizują one niezgodność wsteczną i zmiany powodujące niezgodność, które wymagają działania dewelopera. Nowy numer wersji będą miały tylko zmiany powodujące przerwanie działania stabilnych interfejsów API. na przykład z wersji 1 na wersję 2.
Mniejsze zmiany: dodatki i poprawki zgodne wstecznie są przedstawiane jako zmiany w istniejącej głównej wersji. Szczegółowe informacje o takich zmianach znajdziesz w notatkach do wersji. Dodatki do podrzędnego interfejsu API, które nie powodują przerw w działaniu, będą wydawane na kanale alfa najnowszej wersji stabilnej lub bezpośrednio na najnowszą wersję stabilną.
Zachody słońca
Co jakiś czas wycofujemy starsze wersje interfejsów API dla sprzedawców. Zobowiązujemy się do 12-miesięcznego okna wycofywania stabilnych głównych wersji (vX) od daty oficjalnego ogłoszenia o wycofaniu.
Jeśli na przykład 15 stycznia 2026 r. wycofamy wersję 1 interfejsu podrzędnego API „Products”, zostanie ona wycofana nie wcześniej niż 15 stycznia 2027 r. Po tym dniu starsza wersja podrzędnego interfejsu API nie będzie już dostępna.
Wersja interfejsu podrzędnego i stan cyklu życia
W tabeli poniżej znajdziesz najnowsze wersje poszczególnych podinterfejsów Merchant API:
| Interfejsy podrzędne API | Wersje alfa | Wersje beta | Stan |
|---|---|---|---|
| Konta | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Usługi | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Dane wejściowe dotyczące produktów | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Lokalne asortymenty | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Asortymenty regionalne | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Źródła danych | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Promocje | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Raporty | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Konwersje | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Powiadomienia | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Opinie | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Ustawienia dostawy | Niedostępne | wersja 1 beta | Aktywna jest wersja beta 1. |
| Product Studio | wersja 1 alfa | Niedostępne | Aktywna jest wersja alfa 1. |
Sprawdzone metody
- Regularnie sprawdzaj informacje o wersji i najnowsze aktualizacje, aby dowiedzieć się o nowych wersjach, dużych aktualizacjach, ulepszeniach oraz o ogłaszaniu i wycofaniach poszczególnych interfejsów API.
- Jeśli interfejs podrzędny API ma co najmniej 2 stabilne wersje, zalecamy korzystanie z najnowszej wersji.
- Zaprojektuj aplikację tak, aby sprawnie obsługiwała różne błędy interfejsów podrzędnych, w tym problemy z siecią, limity szybkości i nowe kody błędów lub komunikaty, które mogą zostać wprowadzone w nowszych wersjach interfejsów podrzędnych.
- Nie czekaj, aż wersja podrzędnego interfejsu API zostanie wycofana, aby zacząć planować uaktualnienie. Rozpocznij ewaluację i testowanie nowych wersji, gdy tylko będą dostępne.
- Jeśli chcesz zgłosić prośbę o dodanie funkcji lub masz wątpliwości dotyczące harmonogramu interfejsów API, skontaktuj się z nami. Informacje o tym, jak skontaktować się z zespołem Merchant API w celu uzyskania pomocy technicznej, znajdziesz w artykule Pomoc dotycząca Merchant API.