Udostępniliśmy dziś nowy zasób w wersji beta - GET /sale/offer-events. To dziennik zdarzeń w ofertach zalogowanego sprzedawcy, który zwraca informacje z ostatnich 24 godzin o:

• wstawieniu oferty ("type": "OFFER_ACTIVATED");
  • zmianie w ofercie ("type": "OFFER_CHANGED");
  • zmianie liczby sztuk w ofercie - zwracany również po zakupie ("type": "OFFER_STOCK_CHANGED");
  • zmianie ceny w ofercie ("type": "OFFER_PRICE_CHANGED");
  • zakończeniu oferty ("type": "OFFER_ENDED").

Eventy zwracamy dla ofert w statusach ACTIVE i ACTIVATING. Oznacza to, że nie otrzymasz eventów dla ofert w statusie INACTIVE i ENDED.

W wywołaniu możesz podać parametry wejściowe, które pozwolą ci dopasować odpowiedź do twoich potrzeb:

• from - podaj id eventu, by uzyskać wszystkie eventy które nastąpiły później (np. from=MTEzMjQzODU3NA);
• limit - podaj liczbę eventów, które chcesz uzyskać w odpowiedzi (domyślnie 100, max. 1000);
• type - podaj typ eventów, które chcesz uzyskać w odpowiedzi (np. type=OFFER_ENDED).

Przykładowy request - którym uzyskasz 200 zdarzeń o zmianie liczby sztuk, które nastąpiły po evencie o "id": "MTU2Mzg2NTM5MTU2Mzg0Ng"

curl -X GET \
'https://api.allegro.pl/sale/offer-events?from=MTU2Mzg2NTM5MTU2Mzg0Ng&limit=200&type=OFFER_STOCK_CHANGED' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Authorization: Bearer {token}'

Więcej informacji na temat nowego zasobu znajdziesz w dokumentacji.