Od dziś skorzystasz z wersji beta.v1 zasobów:

• 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.

Jakie zmiany wdrożyliśmy w wersji beta.v1?

1. W wersji beta.v1 wdrożyliśmy nową strukturę, gdzie:

   • dotychczasowe pola “comment” jest obiektem, w którym zwracamy dwa nowe pola:
     • “text” - treść komentarza do oceny,
     • “language” - język, w którym komentarz został wystawiony oryginalnie, przed automatycznym tłumaczeniem,
   • w obiekcie “answer” dodaliśmy dwa nowe pola:
     • “text” - treść odpowiedzi do oceny,
     • “language” - język, w którym odpowiedź do oceny została wystawiona, przed automatycznym tłumaczeniem,
   • dodaliśmy nowy obiekt “exclusion” - wykluczenie oceny, w którym zwracamy:
     • “reason” - powód, dla którego ocena została wyłączona z obliczania średniej oceny użytkowników,
   • dodaliśmy nowy obiekt “justifications” - lista uzasadnień wybranych przez kupującego podczas tworzenia oceny:
     • "text" - uzasadnienie dla oceny sprzedaży,
     • "visibleForBuyer" - widoczność uzasadnienia dla kupującego,
   • usunęliśmy obiekt "rates", gdzie dotychczas zwracaliśmy oceny gwiazdkowe,
   • usunęliśmy pola "excludedFromAverageRates" i "excludedFromAverageRatesReason".

2. Dodaliśmy Accept-Language - za pomocą którego ustawisz oczekiwany język komunikatów. Nagłówek jest dostępny tylko dla wersji treści “application/vnd.allegro.beta.v1+json”. Dostępne wartości: en-US, pl-PL, uk-UA, sk-SK, cs-CZ, hu-HU. Jeśli jej nie przekażesz, domyślnie zwrócimy wyniki z wartością: pl-PL.

3. Aby dostosować się do zmian, wystarczy, że zmienisz wartość w nagłówku Accept z “application/vnd.allegro.public.v1+json” na “application/vnd.allegro.beta.v1+json”.

Przykładowy request dla /sale/user-ratings:

curl -X GET \
'https://api.allegro.pl/sale/user-ratings’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Accept-Language: pl-PL \

Przykładowy response dla /sale/user-ratings:

 {
   "ratings": [
       {
           "id": "67a078f6d2446c059c6e44e9",
           "createdAt": "2025-05-03T08:06:14.462Z",
           "lastChangedAt": "2025-05-03T08:06:14.462Z",
           "recommended": false,
           "buyer": {
               "id": "104778524",
               "login": "Buyer-test-account"
           },
           "comment": { // komentarz do oceny sprzedaży
               "text": "Good transaction", // treść komentarza do oceny
               "language": "en" // język, w którym komentarz został wystawiony oryginalnie, przed automatycznym tłumaczeniem
           },
           "exclusion": { // wykluczenie oceny sprzedaży
               "reason": "test" // powód, dla którego ocena została wyłączona z obliczania średniej oceny użytkowników
           },
           "order": {
               "id": "7f315620-b857-11ef-9529-1b1ca444b49b",
               "offers": [
                   {
                       "id": "7775984789",
                       "title": "Lego Star Wars Statek Rycerzy Ren 75284"
                   }
               ]
           },
           "answer": {
               "text": "Dziękuję za ocenę", // treść odpowiedzi do oceny,
               "createdAt": "2025-02-03T08:07:32.822Z",
               "language": "pl" // język, w którym odpowiedź do oceny została wystawiona, przed automatycznym tłumaczeniem
           },
           "removal": {
               "possibleTo": "2025-06-12T07:07:41.580Z"
           },
           "justifications": [ // lista uzasadnień wybranych przez kupującego podczas tworzenia oceny
               {
                   "text": "Nieuprzejma obsługa", // uzasadnienie dla oceny sprzedaży
                   "visibleForBuyer": true // widoczność uzasadnienia dla kupującego
               }
           ]
       }
   ]
}

Dlaczego wprowadzamy tę zmianę?

Zasoby:

• GET /sale/user-ratings,
• GET /sale/user-ratings/{ratingId},

funkcjonują obecnie w wersji public.v1, jednak struktura odpowiedzi nie jest dostosowana do aktualnych warunków i zasad wystawiania ocen sprzedaży. 18 lutego 2025 usunęliśmy gwiazdki z oceny sprzedaży, co oznacza, że kupujący nie mogą już oceniać zgodności z opisem i obsługi kupującego. Ponadto w ostatnim czasie wdrożone zostały tzw. uzasadnienia do oceny, których obecna struktura dostępna na public.v1 nie uwzględnia.

Jakie są kolejne kroki?

W przyszłości planujemy przenieść strukturę zasobu w wersji beta.v1 na wersję public.v1, poinformujemy o tym z odpowiednim wyprzedzeniem.