[NEWS] GET /sale/product-offers/{offerId}/parts - pobierz wybrane elementy oferty / GET /sale/product-offers/{offerId}/parts - retrieve selected parts of the offer

[MaciejFrackowiak]

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.

---

Effective offer management based on data updates is at the heart of the Allegro API integration, so we have introduced new options for retrieving offer data.

How is it now?

Using GET /sale/product-offers/{offerId}, you can retrieve the details of the selected offer - the response will return all the fields that comprise it.

What have we changed?

We have released today a new GET /sale/product-offers/{offerId}/parts resource, which will retrieve only selected items of the offer. In the first stage, you will retrieve information about:

• the current number of items on offer (“stock”),
• the current price on offer (“price”) - both in the base and additional markets.

The resource will return data according to the response model for GET /sale/product-offers/{offerId}, but faster and more reliably. It is subject to less restrictive limits on the number of requests per time (at least twice that of “full GET”).

In the future, we plan to make more fields of the offer available.

Sample 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' \

Why have we made the change?

We are responding to the need of sellers who want to get information only about the key data of the offer, without retrieving the full model of the offer.