[NEWS] [Wyraź swoją opinię] Sekcja ‘Pasuje do pojazdów’ w opisie oferty - nowy zasób GET /sale/compatible-products/search.

W sierpniu 2018 dodaliśmy nową strukturę w modelu oferty - [Pasuje do pojazdów](https://developer.allegro.pl/news/2018-08-08-Pasuje/). Obecnie w tej sekcji możesz tekstowo dodać listę marek i modeli aut, do których pasuje oferowana część.

Planujemy rozbudować tę funkcjonalność o dedykowany zasób, którym możesz **wyszukać kompatybilne pojazdy** na podstawie podanej frazy. W odpowiedzi otrzymasz identyfikatory, które będziesz mógł wykorzystać przy tworzeniu oferty w sekcji "compatibilityList". W tej sekcji nie będzie można już wprowadzać informacji w postaci tekstowej tylko identyfikatory.

Dzięki zmianie kupujący szybciej trafią na Twoją ofertę, a dokładny opis pojazdów do jakich pasuje dana część ułatwi im podjęcie decyzji.

Poniżej opis zasobu, który planujemy wdrożyć. Chcielibyśmy poznać wasze zdanie na temat nowego zasobu, który planujemy wdrożyć.
- Czy zaproponowana struktura zapytania i odpowiedzi jest dla was odpowiednia?
- Jeśli nie - co waszym zdaniem warto byłoby zmienić/dodać?

Swoje sugestie zamieszczajcie pod postem, bądź przesyłajcie do nas przez [formularz kontaktowy](https://allegro.pl/pomoc/kontakt?subjectId=517305f2-5ea1-4b3b-9080-d4cc960ab6a1&kategoria=a0f7ce34-c6f6-43e6-af7d-ad39bacce619). W treści zaznaczcie proszę, że sugestię przesyłacie do ticketa numer 877 Na GitHub.

**GET /sale/compatible-products/search**
To zasób, którym wyszukasz kompatybilne pojazdy na podstawie podanej frazy. Otrzymane w ten sposób identyfikatory przekaż, gdy będziesz tworzył treść sekcji "compatibilityList". Zasób zwróci maksymalnie 200 wyników, dlatego wprowadź możliwie jak najbardziej szczegółową frazę.

Przy wywołaniu tej metody skorzystaj z poniższych zmiennych:
- **type** - rodzaj pojazdów wśród jakich będziemy szukać zadanej frazy. Początkowo będzie dostępna tylko jedna wartość CAR (samochody osobowe).
- **phrase** - szukana fraza, im precyzyjniej określisz co szukasz tym bardziej dopasowane wyniki zwrócimy.

**Przykładowy request:**
curl -X GET
'https://api.allegro.pl/sale/compatible-products/search?type=CAR&phrase=Volkswagen Golf III Hatchback 1993-1997 1.9 TDI 90KM kod silnika: AHU skrzynia manualna 5 biegowa napęd AWD'
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Content-Type: application/vnd.allegro.beta.v1+json' \
-H "Authorization: Bearer {token}"

**Przykładowa odpowiedź:**
{
"count": 3, **-- liczba zwróconych elementów w tablicy**
compatibleProducts
"compatibleProducts": [ **-- lista kompatybilnych pojazdów**
{
"id": "ae28e6178d908308008ab60fb0033fc0f9fce7d220c1715275b1fe2f0b9f3df6",
**-- identyfikator kompatybilnego pojazdu**
"text": "Volkswagen Golf III Hatchback 1.9 TDI (kod: AHU ) produkcja wersji: 1993-1997 moc: 90KM/kW manualna 5 biegowa FWD" **-- opis kompatybilnego pojazdu**
},
{
"id": "f50dbdfada9daef2051b69d319f6b36b2db70d9771910f1f55b2d1a14fc4e7b9",
"text": "Volkswagen Golf III Hatchback 1.9 TDI (kod: AHU ) produkcja wersji: 1993-1997 moc: 90KM/kW manualna 5 biegowa AWD Syncro"
},
{
"id": "b7d624229f9d69e366eda66c43cc1897bd607f11a99fe149f5af160c2f79b3a9",
"text": "Volkswagen Golf III Hatchback 1.9 TDI (kod: ALE ) produkcja wersji: 1993-1997 moc: 90KM/kW manualna 5 biegowa FWD"
}
]
}

Poniżej **przykład uzupełnionej sekcji "compatibilityList"** przy pomocy identyfikatorów jakie otrzymasz w odpowiedzi.

“compatibilityList” : {
“items” : [
{“id”:”ae28e6178d908308008ab60fb0033fc0f9fce7d220c1715275b1fe2f0b9f3df6”},
{“id”:”f50dbdfada9daef2051b69d319f6b36b2db70d9771910f1f55b2d1a14fc4e7b9”},
{“id”:”b7d624229f9d69e366eda66c43cc1897bd607f11a99fe149f5af160c2f79b3a9”}
]
}