Od 6 marca 2025 udostępniamy nową wersję beta.v1 dla:

• GET /sale/user-ratings - pobierz listę ocen sprzedaży,
• GET /sale/user-ratings/{ratingId} - pobierz szczegółowe informacje dotyczące wybranej oceny sprzedaży.

Nową strukturę dostosowaliśmy do aktualnych warunków i zasad wystawiania oceny sprzedaży.

Co zmienimy 2 listopada 2026?

1. Zastąpimy aktualną wersję public.v1 strukturą, którą zwracaliśmy dla beta.v1. Aby umożliwić bezproblemowe przejście, beta.v1 będzie dostępna jeszcze przez kilka dni.

2. Ponadto pole “firstNegativeReviewInLast30Days”:

   • oznaczymy jako deprecated i dla ocen wystawionych po 26 sierpnia 2026 r. nie zwrócimy go w odpowiedzi,
   • planujemy usunąć w III kwartale 2027 roku.

Co musisz zrobić?

1. Jeżeli korzystasz z beta.v1:

   • Przetestuj poprawność działania swojej integracji, a następnie 2 listopada 2026 zmień wartość w nagłówku Accept z application/vnd.allegro.beta.v1+json na application/vnd.allegro.public.v1+json. Nie zwlekaj ze zmianą - wersja beta pozostanie dostępna jedynie przez kilka dni po wdrożeniu.

2. Jeżeli korzystasz z public.v1:

   • Do 2 listopada: dostosuj kod do struktury znanej z beta.v1, aby przygotować aplikację na nadchodzącą zmianę; zmiany opisaliśmy w naszym ostatnim newsie,
   • Od 2 listopada: nie musisz zmieniać nagłówka Accept, jednak zweryfikuj na środowisku produkcyjnym, czy Twoja aplikacja prawidłowo przetwarza nową strukturę danych.