26 stycznia 2021
Produktyzacja - w danych produktów dodaliśmy nowe kategorie, w których możesz wystawić ofertę połączoną z Katalogiem produktów.
Od dziś, w przypadku gdy produkt pasuje do wielu podobnych do siebie kategorii, możesz wystawić ofertę powiązaną z tym produktem w innej, zdefiniowanej przez nas podobnej kategorii.
W odpowiedzi na GET /sale/products/{productId} zwrócimy nową listę:
- category.similar
w której wskazujemy id kategorii podobnych. Skorzystaj z wybranego identyfikatora, aby wystawić ofertę sprzedaży produktu w jednej ze zwróconych kategorii.
Przykładowy request:
curl -X GET \
‘https://api.allegro.pl/sale/products/b2b61e23-b580-4471-b653-6ed25fd179f7’ \
-H 'Authorization: Bearer {token}' \
-H 'accept: application/vnd.allegro.public.v1+json'
Przykładowy response:
{
"id": "b2b61e23-b580-4471-b653-6ed25fd179f7",
"name": "BIO Pochodnia",
"category": {
"id": "261573",
"similar": [
{
"id": "110914"
},
{
"id": "305121"
}
]
}
…
}
Ważne! Zbiory kategorii podobnych są definiowane przez nas - zwracamy je w odpowiedzi na GET /sale/products/{productId} - nie możesz tworzyć ich samodzielnie. Zbiór kategorii podobnych jest aktualnie ograniczony, jednak będziemy go systematycznie rozszerzać.
Kategorie mogą różnić się dostępnymi w nich parametrami, dlatego część uzupełnionych w produkcie parametrów może nie być zgodna z tymi możliwymi do użycia w kategorii podobnej.
Użyj GET /sale/products/{productId}?category.id={similarCategoryId}, a w parametrze category.id podaj id ze zwróconego przez nas zbioru kategorii podobnych, aby filtrować uzupełnione w produkcie parametry dla wybranej kategorii podobnej. W odpowiedzi otrzymasz parametry produktu, które możesz wykorzystać podczas wystawiania oferty we wskazanej kategorii podobnej.
Jednocześnie rozszerzyliśmy strukturę żądania w części ofertowej w:
o nowe pole - category.id. Uzupełnij to pole o wartość id, którą zwracamy w danych produktu dla jednej z kategorii podobnych. Dzięki temu wystawisz ofertę powiązaną z produktem w wybranej kategorii podobnej.
Jeżeli w odpowiedzi otrzymasz informację, aby uzupełnić brakujące parametry obowiązkowe, przekaż je w obiekcie product. Identyfikator parametru wraz z wartością sprawdzisz za pomocą GET /sale/{categoryId}/parameters.
Identyfikatory kategorii podobnych możesz użyć również, gdy wiążesz ofertę z produktem używając:
Aktualnie, w polu category.id zamiast id kategorii głównej, możesz przekazać jedną z wartości dostępnych w produkcie w polu category.similar.id.
Więcej informacji, jak wystawić ofertę powiązaną z produktem, znajdziesz w naszych poradnikach: