Allegro REST API

gdzie?

Polska | polski | PLN
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Pierwsze kroki
  • Wystawianie oferty z produktem
  • Wystawianie i zarządzanie ofertą w serwisach zagranicznych
  • 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
  1. Allegro REST API
  2. Aktualności
  3. Udostępniliśmy nowy zasób, dzięki któremu sprawdzisz sugerowane kategorie dla podanej frazy

16 września 2020

Udostępniliśmy nowy zasób, dzięki któremu sprawdzisz sugerowane kategorie dla podanej frazy

Udostępniliśmy dziś nowy zasób GET /sale/matching-categories, za pomocą którego po podaniu frazy pobierzesz sugerowaną listę kategorii, w których możesz wystawić swój przedmiot. Dzięki temu łatwiej i szybciej zidentyfikujesz odpowiednią kategorię.

W żądaniu przekaż parametr name i podaj w nim wyszukiwaną frazę, np. name=bmw x3. W odpowiedzi otrzymasz listę sugerowanych kategorii.

Przykładowy request:

curl -X GET \
    'https://api.allegro.pl/sale/matching-categories?name=bmw x3' \
    -H 'Authorization: Bearer {token}' \
    -H 'Accept: application/vnd.allegro.public.v1+json'

Przykładowy response:

{
"matching_categories": [
    {
      "id": "250885",                    -- identyfikator sugerowanej kategorii.
      "name": "Wahacze",                -- nazwa sugerowanej kategorii.
      "parent": {                        -- kategoria nadrzędna w stosunku do
                                        sugerowanej kategorii:
                                        dzięki tej strukturze poznasz dokładną
                                        ścieżkę sugerowanej kategorii.
        "id": "250882",                    -- identyfikator kategorii nadrzędnej.
        "name": "Wahacze i elementy",    -- nazwa kategorii nadrzędnej.
        "parent": {
          "id": "8683",
          "name": "Układ zawieszenia",
          "parent": {
            "id": "620",
            "name": "Części samochodowe",
            "parent": {
              "id": "3",
              "name": "Motoryzacja",
              "parent": null
            }
          }
        }
      }
    },
    . . .
     {
      "id": "255100",
      "name": "Lampy przeciwmgielne",
      "parent": {
        "id": "255098",
        "name": "Lampy przednie i elementy",
        "parent": {
          "id": "623",
          "name": "Oświetlenie",
          "parent": {
            "id": "620",
            "name": "Części samochodowe",
            "parent": {
              "id": "3",
              "name": "Motoryzacja",
              "parent": null
            }
          }
        }
      }
    }
  ]
}