[NEWS] Ocena sprzedaży - dodaliśmy zasób do pobierania informacji o wskazanej ocenie / User’s ratings - we have introduced resource for retrieving information about given rating

Dodaliśmy nowy endpoint, dzięki któremu pobierzesz informacje o wskazanej ocenie sprzedaży - [/sale/user-ratings/{ratingId}](https://developer.allegro.pl/documentation#operation/getUserRatingUsingGET).

**Przykładowy request:**

```json5
curl -X GET \
'https://api.allegro.pl/sale/user-ratings/{ratingId}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
```
>
**Przykładowany response:**
```json5
{
"id": "5f245afca39ce1004cb8fc37", - ID oceny
"createdAt": "2021-07-30T19:55:08.555Z", - data utworzenia oceny
"editedAt": "2021-08-02T14:52:08.555Z", - data ostatniej edycji oceny
"lastChangedAt": "2021-08-02T14:52:08.555Z", - data utworzenia oceny lub
data ostatniej edycji
(jeśli ocena była edytowana)
"recommended": true, - czy ocena jest pozytywna
"buyer": { - informacje o kupującym
"id": "33811291", - ID kupującego
"login": "test_login" - login kupującego
},
"comment": "Świetny kontakt, ekspresowa realizacja", - komentarz kupującego
"rates": { - oceny poszczególnych obszarów
"description": 5, - zgodność z opisem
"service": 5, - obsługa kupującego
"deliveryCost": 5 - koszty wysyłki
},
"order": { - informacje o zamówieniu
"id": "8b1664b2-c3bc-11ea-820a-db7a264e2a97", - ID zamówienia
"offers": [ - oferty, które wchodzą w skład
zamówienia
{
"id": "8481327606", - ID oferty
"title": "oferta testowa", - tytuł oferty
"snapshot": - ID zrzutu oferty w momencie
zakupu
"MjAyMC0wNy0xMVQyMToyMjozMS4yMjhaO2J1eWVyOzgxNDc5MTU2OTBhMjhmNmEzMGM5ZThjMDUzNmE2YT"
}
]
},
"removal": { - informacje o prośbach o
usunięcie oceny
"possibleTo": "2021-08-13T19:55:08.555Z" - data, do kiedy sprzedawca
może wysłać prośbę o usunięcie
oceny
},
"excludedFromAverageRates": false - czy dana ocena jest wyłączona
z ogólnej średniej ocen
"excludedFromAverageRatesReason": "Rating not unique" - powód, dlaczego dana
ocena jest wyłączona
z ogólnej średniej ocen
}
]
}
```
>
Więcej informacji o tym, jak zarządząc ocenami sprzedaży, znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-kontem-danymi-uzytkownika-ZM9YAKgPgi2#ocena-sprzedazy).

-----

We have added new endpoint, thanks to which you can retrieve information about given rating - [/sale/user-ratings/{ratingId}](https://developer.allegro.pl/documentation#operation/getUserRatingUsingGET).

**Sample request:**

```json5
curl -X GET \
'https://api.allegro.pl/sale/user-ratings/{ratingId}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
```
>
**Sample response:**
```json5
{
"id": "5f245afca39ce1004cb8fc37", - rating ID
"createdAt": "2021-07-30T19:55:08.555Z", - rating creation datetime
"editedAt": "2021-08-02T14:52:08.555Z", - date of the last rating edit
"lastChangedAt": "2021-08-02T14:52:08.555Z", - date of creation of the rating
or the last edit date
(if the rating was edited)
"recommended": true, - whether the buyer recommends the order
"buyer": { - buyer data
"id": "33811291",
"login": "test_login"
},
"comment": "Świetny kontakt, ekspresowa realizacja", - buyer comment
"rates": { - ratings of particular areas
"description": 5, - description rate value
"service": 5, - service rate value
"deliveryCost": 5 - delivery cost rate value
},
"order": { - order data
"id": "8b1664b2-c3bc-11ea-820a-db7a264e2a97",
"offers": [ - list of order offers
{
"id": "8481327606",
"title": "oferta testowa",
"snapshot":
"MjAyMC0wNy0xMVQyMToyMjozMS4yMjhaO2J1eWVyOzgxNDc5MTU2OTBhMjhmNmEzMGM5ZThjMDUzNmE2YT"
}
]
},
"removal": { - information about requests
to remove user rating
"possibleTo": "2021-08-13T19:55:08.555Z" - date until a removal request can
be submitted
},
"excludedFromAverageRates": false - whether this rating was not
included in calculating the average user rates
"excludedFromAverageRatesReason": "Rating not unique" - the reason why this rating
was not included in calculating average user rates
}
]
}
```
>
You can find more information on how to manage user’s ratings in [our tutorial](https://developer.allegro.pl/tutorials/account-and-user-data-management-jn9vBjqjnsw#user-s-ratings).