allegro / allegro-api

Issue tracker and wiki for Allegro REST API
https://developer.allegro.pl/
213 stars 39 forks source link

[NEWS] Zarządzanie czarną listą #1939

Open PrzemyslawLukanowski opened 5 years ago

PrzemyslawLukanowski commented 5 years ago

Udostępniliśmy zasoby (w wersji beta), dzięki którym jako sprzedawca możesz zarządzać czarną lista kupujących. Osoba dodana do czarnej listy nie może kupować w twoich ofertach. W każdej chwili możesz usunąć z niej użytkownika, tym samym ponownie pozwolisz mu na zakup w twoich ofertach.

Aby dodać kupującego do czarnej listy, skorzystaj z zasobu POST /sale/blacklisted-users.

Ważne! W strukturze musisz przesłać login lub id kupującego.

Przykładowy request:

curl -X POST \
https://api.allegro.pl/sale/blacklisted-users \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Content-Type: application/vnd.allegro.beta.v1+json' \
-d ‘{
    "user": {
         "id": 123456,                -- wymagane (jeśli nie przekazujesz loginu), 
                                          id kupującego
         "login": "bad_buyer"             -- wymagane (jeśli nie przekazujesz id), 
                                          login kupującego
    },
    "note": "Rude person"             -- powód dodania do czarnej listy
}’

Przykładowy response:

{
    "user": {
        "id": 123456,
         "login": "bad_buyer"
    },
    "note": "Rude person",
    "createdAt": "2019-05-08T09:45:818Z"   -- data dodania do czarnej listy
}

Aktualną czarną listę pobierzesz za pomocą zasobu GET /sale/blacklisted-users

Przykładowy response:

{
    "blacklistedUsers": [
        {
            "user": {
                "id": 123456,
                "login": "bad_buyer"
            },
            "note": "Rude person",
            "createdAt": "2019-07-04T10:41:31.135Z"
        },
        {
            "user": {
                "id": 012345,
                "login": "bad_buyer1"
            },
            "note": "Rude person",
            "createdAt": "2019-07-04T10:35:10.013Z"
        }
    ],
    "offset": 0,
    "limit": 25,                -- limit wyświetlanych wyników przy
                            pojedynczym zapytaniu
    "total": 2                      -- liczba użytkowników przypisanych
                            do czarnej listy
}

Maksymalnie przy zapytaniu możesz wyświetlić do 25 wyników. Aby zwrócić kolejne, użyj parametru “offset”, gdzie jako wartość podaj wielokrotność limitu.

Aby usunąć kupującego z czarnej listy wykorzystaj zasób DELETE /sale/blacklisted-users/{userId}.

allegrofan commented 2 years ago

Po zmianach przestało działać. [error] => unauthorized [error_description] => Authorization header does not contain space after 'Bearer'

PrzemyslawLukanowski commented 2 years ago

@allegrofan Tutaj komunikat wskazuje raczej na inną przyczynę. Upewnij się, że w nagłówku Authorization wstawiasz spację między Bearer a tokenem.

allegrofan commented 2 years ago

Tak, komunikat wskazuje na inną przyczynę, problem w tym, że spacja jest i w innych wywołaniach działa bez problemu.

PrzemyslawLukanowski commented 2 years ago

Nie mogę potwierdzić, aby występował problem z działaniem zasobów - nasze logi wskazują, że wywołania metod POST i DELETE u innych użytkowników kończą się prawidłową odpowiedzią. Prześlij proszę przykładowy request wraz z response przez nasz formularz kontaktowy, zweryfikujemy to. W zgłoszeniu dopisz, że dane dotyczą wątku #1939 na GitHub.