09 lipca 2019
Zarządzanie czarną listą
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
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}.
