Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-03 UTC."],[],[],null,["This guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\nVersioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\nVersion changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API\n will be released to the alpha channel of the latest stable version or\n directly to the latest stable version.\n\nSunset policy\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reports | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
