Z tego przewodnika dowiesz się, jak interfejs Merchant API obsługuje wersjonowanie, wydania i cykl życia różnych wersji.
Schemat wersji
Interfejs Merchant API stosuje strategię wersji na poziomie interfejsu API. Oznacza to, że każdy interfejs API, np. Produkty w Merchant API, będzie miał własny cykl życia wersji.
Formatowanie i prezentacja wersji
Stabilne wersje podrzędnych interfejsów API: jeśli podrzędny interfejs API jest w stabilnej wersji, wszystkie jego metody są w stabilnej wersji. Stabilna wersja podrzędna interfejsu API jest oznaczana jako vX (np. v1, v2). Są to główne wersje gotowe do wdrożenia w środowisku produkcyjnym.
Wersje alfa interfejsów API: jeśli interfejs API jest w wersji alfa, wszystkie jego metody są w wersji alfa. Wersja alfa interfejsu API jest oznaczana jako vXalpha (np. v1alpha, v2alpha). Zawierają one eksperymentalne funkcje w ramach wcześniejszego dostępu, które są przeznaczone do testowania i szybkiego wprowadzania zmian. Wersje alfa nie mają gwarancji stabilności, nie mają określonego okresu użytkowania i mogą zostać zmienione lub wycofane z 30-dniowym wyprzedzeniem.
Zmiany wersji
Zwiększenie numeru wersji głównej (np. z wersji 1 na wersję 2): sygnalizuje to zmiany powodujące niezgodności wsteczne, które wymagają działania dewelopera. Tylko zmiany powodujące niezgodność w stabilnych interfejsach API będą miały nowy numer wersji. Na przykład z wersji 1 na wersję 2.
Drobne zmiany: dodatki lub poprawki zgodne wstecznie są prezentowane jako zmiany w istniejącej wersji głównej. Szczegółowe informacje o takich zmianach znajdziesz w informacjach o wersji. Niepowodujące przerw w działaniu dodatki do interfejsu API będą publikowane na kanale alfa najnowszej stabilnej wersji lub bezpośrednio w najnowszej stabilnej wersji.
Zasady wycofywania
Okresowo wycofujemy starsze wersje interfejsów API sprzedawcy. W przypadku stabilnych wersji głównych (vX) zobowiązujemy się do 12-miesięcznego okresu wycofywania, który rozpoczyna się od oficjalnego ogłoszenia o wycofaniu.
Jeśli na przykład 15 stycznia 2026 r. wycofamy z użycia interfejs API produktów w wersji 1, zostanie on wyłączony nie wcześniej niż 15 stycznia 2027 r. Po tej dacie starsza wersja interfejsu API nie będzie już dostępna.
Wersja interfejsu API i stan cyklu życia
W tabeli poniżej znajdziesz najnowsze wersje każdego interfejsu API Merchant:
| Sub-API | Wersje | Stan |
|---|---|---|
| Konta | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Konwersje | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Źródła danych | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Zapasy | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Rozwiązywanie problemów | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Program partnerski danych o asortymencie lokalnym | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Powiadomienia | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Śledzenie zamówień | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Produkty | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Product Studio | v1alpha | Aktywne |
| Promocje | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Limit | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Raporty | v1 v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
| Opinie | v1alpha v1beta |
Aktywny Wycofany 28 lutego 2026 r. |
Sprawdzone metody
- Regularnie sprawdzaj informacje o wersji i najnowsze aktualizacje, aby być na bieżąco z nowymi wersjami, ważnymi aktualizacjami, ulepszeniami i ogłoszeniami dotyczącymi wprowadzenia i wycofania interfejsów API.
- Jeśli podrzędny interfejs API ma co najmniej 2 stabilne wersje, zalecamy korzystanie zawsze z najnowszej wersji.
- Zaprojektuj aplikację tak, aby prawidłowo obsługiwała różne błędy interfejsu API, w tym problemy z siecią, limity szybkości i nowe kody lub komunikaty o błędach, które mogą zostać wprowadzone w nowszych wersjach interfejsu API.
- Nie czekaj, aż wersja podrzędna interfejsu API zostanie wycofana, aby rozpocząć planowanie uaktualnienia. Rozpocznij ocenianie i testowanie nowych wersji, gdy tylko będą dostępne.
- Jeśli masz prośby o dodanie funkcji lub uwagi dotyczące planu rozwoju interfejsu API, skontaktuj się z nami. Informacje o tym, jak skontaktować się z zespołem Merchant API w celu uzyskania pomocy technicznej, znajdziesz w artykule Jak uzyskać pomoc dotyczącą interfejsu API sprzedawcy.