Allegro REST API

gdzie?

Polska | polski | PLN
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Wystawianie oferty produktu
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Oferty wielowariantowe
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
Dokumentacja
Regulamin
Kontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  1. Allegro REST API
  2. Aktualności
  3. Zarządzanie czarną listą

09 lipca 2019

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}.

Allegro

Serwisy Grupy Allegro

  • Allegro.cz
  • Allegro.sk
  • Allegro.hu
  • Mall.hr
  • Mimovrste.com
  • Onedelivery.cz
zamknij

Dostosuj ustawienia wyświetlania

ustawienia dotyczą tylko tej przeglądarki