W związku z wprowadzeniem katalogu samochodów (opisanego tutaj), nie będziemy wspierać już poprzedniej wersji trybu dodawania ogłoszeń (opisanego w podlinkowanym artykule jako “Dotychczasowy”). Nie oznacza to, że automatycznie przestaje on działać, natomiast w przypadku wystąpienia trudności z dodaniem oferty, np w związku z parametrem wersji/generacji, należy skorzystać z nowego trybu.
W dotychczasowym trybie dodawania ogłoszeń, przed utworzeniem katalogu samochodów, parametr “version” odnosił się de facto do generacji samochodu, z podziałem na lata w jakich były produkowane. W wersji v2 wprowadzony został podział, i tak:
- “Generation” odnosi się do kolejnych generacji danego modelu, z podziałem na lata w jakich były one produkowane.
- “Version” dotyczy natomiast konkretnych wersji silnikowych i wyposażenia. Jest on związany z konkretnym rokiem produkcji danego modelu, a także parametrami silnika i rodzajem skrzyni biegów.
Obecnie wartość dla generacji powinna być wysyłana w polu "generation", natomiast nie ma wzoru na skorzystanie ze starych wartości i zmapowanie ich. Aby pobrać generacje, należy zgodnie z dokumentacją skorzystać z zapytania
GET /categories/:category_id/models/:brand_code/generations/:model_code
Przykładowo, dla zapytania
GET /categories/:category_id/models/kia/generations/ceed ,
otrzymamy poniższą odpowiedź.
"options": {
"gen-i-2006-2012": {
"pl": "I (2006-2012)",
"en": "I (2006-2012)"
},
"gen-ii-2012-ceed": {
"pl": "II (2012-)",
"en": "II (2012-)"
},
"gen-iii-2018": {
"pl": "III (2018-)",
"en": "III (2018-)"
Jeśli chodzi natomiast o aktualne wartości dla parametru “version”, to przykładowe zapytanie i odpowiedź dla Kia Ceed wyglądają następująco:
https://www.otomoto.pl/api/open/categories/29/models/kia/versions/ceed?v=2&fuel_type=petrol
"options": {
"ver-1-0-t--gdi-100-isg": {
"pl": "1.0 T-GDI 100 ISG",
"en": "1.0 T-GDI 100 ISG"
},
"ver-1-0-t--gdi-gt--line": {
"pl": "1.0 T-GDI GT-Line",
"en": "1.0 T-GDI GT-Line"
},
"ver-1-0-t--gdi-isg": {
"pl": "1.0 T-GDI ISG",
"en": "1.0 T-GDI ISG"
Zgodnie z działaniem katalogu samochodów, możliwość wybrania konkretnej wersji jest uzależniona od parametrów silnika czy skrzyni biegów. Można to sprawdzić bezpośrednio z poziomu formularza dodawania ogłoszenia na Otomoto, z dowolnego konta prywatnego czy biznesowego.
Kolejność podawania parametrów jest następująca:
1) rok produkcji
2) marka i model pojazdu
3) rodzaj paliwa, moc i pojemność silnika
4) liczba drzwi
5) skrzynia biegów
6) wersja (jeśli dostępna)
Aby uzyskać wersje dostępne dla konkretnego rodzaju paliwa, silnika i skrzyni biegów, należy postąpić zgodnie ze ścieżką .
- Odpytać o dostępne rodzaje paliwa danego rocznika, marki i modelu
- Następnie, o dostępne moce silnika dla kombinacji z pkt 1, później o dostępne pojemności silnika dla wybranej mocy itd. Po uzyskaniu pełnej liczby parametrów, można odpytać system o dostępne wersje
Przykładowo - najpierw należy wysłać zapytanie jak niżej, aby określić dostępne moce silnika w danym modelu (i np jego konkretnym roczniku i roku produkcji).
/categories/:category_id/models/:brand_code/engine_powers/:model_code
Dalej, dla uzyskanych parametrów - można wysłać kolejne zapytanie o dostępne pojemności silnika, liczbę drzwi itd. Do takiego zestawu parametrów można przypisać ostatecznie parametr "version" w jego obecnym formacie.