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