Od dziś skorzystasz z wersji beta.v1 zasobu /users/{userId}/ratings-summary, za pomocą którego pobierzesz podsumowanie statystyk ocen sprzedaży dla dowolnego użytkownika. 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ę, w której zwrócimy dwa nowe obiekty:

   • “statistics” - podsumowanie statystyk ocen sprzedaży, z rozróżnieniem na pola:
     • “received” - oceny otrzymane,
     • “excluded” - wykluczone,
     • “removed” - usunięte (w zależności od przyczyny usunięcia, wartości zwracamy w polach: "total", "byAdmin", "byBuyer", "byBuyerDueToCompensation"),
   • “user” - informacje o użytkowniku, gdzie w polu:
     • “numberOfProductsSoldWithin30Days” - zwracamy liczbę produktów sprzedanych przez użytkownika w ciągu ostatnich 30 dni,
     • "createdAt" - zwracamy datę utworzenia konta.

2. Usunęliśmy obiekt "averageRates", ponieważ ze względu na brak ocen gwiazdkowych w nowej ocenie sprzedaży, nie jest on już potrzebny.

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:

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

Przykładowy response:

{
    "recommended": { // liczba polecających użytkowników
        "unique": 2,
        "total": 4
    },
    "notRecommended": { // liczba nie polecających użytkowników
        "unique": 0,
        "total": 0
    },
    "recommendedPercentage": "100,0", // Procent unikalnych kupujących polecających sprzedawcę
    "statistics": { // podsumowanie statystyk ocen sprzedaży,
        "received": { // otrzymane
            "total": 4
        },
        "excluded": { // wykluczone
            "total": 0
        },
        "removed": { // usunięte
            "total": 0,
            "byAdmin": 0, // liczba ocen usuniętych przez administratora
            "byBuyer": 0, // liczba ocen usuniętych przez kupującego
            "byBuyerDueToCompensation": 0 // liczba ocen usuniętych przez kupującego z powodu rekompensaty
        }
    },
    "user": {
        "numberOfProductsSoldWithin30Days": 32, // liczba produktów sprzedanych przez użytkownika w ciągu ostatnich 30 dni

        "createdAt": "2024-02-07" // data utworzenia konta
    }
}

Dlaczego wprowadzamy tę zmianę?

Zasób /users/{userId}/ratings-summary funkcjonuje 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.

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.