18 marca 2025
GET /sale/product-offers/{offerId}/parts - pobierz wybrane elementy oferty
Efektywne zarządzanie ofertami bazujące na aktualizacji danych to sedno integracji z API Allegro, dlatego wprowadziliśmy nowe możliwości pobierania danych oferty.
Jak jest obecnie?
Korzystając z GET /sale/product-offers/{offerId}, możesz pobrać szczegółowe dane wybranej oferty - w odpowiedzi zwrócimy wszystkie pola, które się na nią składają.
Co zmieniliśmy?
Udostępniliśmy dzisiaj nowy zasób GET /sale/product-offers/{offerId}/parts, dzięki któremu pobierzesz tylko wybrane elementy oferty. W pierwszym etapie pobierzesz informacje o:
- aktualnej liczbie sztuk w ofercie (“stock”),
- aktualnej cenie w ofercie (“price”) - zarówno na rynku bazowym, jak i na rynkach dodatkowych.
Zasób zwróci dane zgodnie z modelem odpowiedzi dla GET /sale/product-offers/{offerId}, jednak szybciej i bardziej niezawodnie. Jest objęty mniej restrykcyjnymi limitami ilości zapytań w czasie (przynajmniej dwukrotnie w stosunku do “pełnego GET”).
W przyszłości planujemy udostępnić kolejne pola oferty.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/product-offers/12359350564/parts?include=stock&include=price' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
Dlaczego wprowadziliśmy zmianę?
Odpowiadamy na potrzebę sprzedających, którzy chcą uzyskać informacje tylko o kluczowych danych oferty, bez konieczności pobierania pełnego modelu oferty.