Zarządzanie czarną listą
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}.
Ważne! W wersji public nie wspieramy automatycznej zmiany przewoźnika “POCZTEX” na “POCZTA_POLSKA”. Upewnij się, że przekazujesz prawidłową wartość w polu carrierId.