CarStat.dev
Obiekty

Obiekt samochodu

Jeden fizyczny pojazd z danymi technicznymi, wszystkimi ogłoszeniami widocznymi dla Twojego klucza oraz, w szczegółowych endpointach, pełnymi raportami. Atrybuty, których źródło nie dostarczyło, są zwykle pomijane, a nie ustawiane na null.

Niedostępne atrybuty główne są często pomijane. Wartości zagnieżdżone mogą mieć wartość null. /search zwraca flagi dostępności bez pełnych tablic raportów; /cars i dokładne wyszukiwania dołączają raporty. Ogłoszenia są ograniczone do zakresu klucza/domen, ale mogą obejmować inne ogłoszenia tego samego scalonego samochodu. Nigdy nie zakładaj, że pierwsze ogłoszenie to to, o które pytałeś.

idstringzawsze w odpowiedzi

Nieprzezroczysty wewnętrzny identyfikator samochodu. Zachowuj go jako ciąg.

has_inspectionsbooleanzawsze w odpowiedzi

Zawsze obecne, jako true lub false. true, gdy samochód ma co najmniej jedną publiczną, opublikowaną inspekcję w jednym ze swoich ogłoszeń; false, gdy nie ma żadnej. /search, /cars i /cars/{car_id} zwracają zapisaną flagę, więc może ona mieć wartość true, gdy inspections jest puste (na przykład gdy raport należy do ogłoszenia spoza zakresu Twoich źródeł). /listing/{domain_id}/{listing_id} wylicza ją ponownie tylko na podstawie tego ogłoszenia. Renderuj raporty z tablicy inspections; flagi używaj do odznak i filtrów.

has_history_reportsbooleanzawsze w odpowiedzi

Zawsze obecne, jako true lub false. true, gdy co najmniej jeden publiczny raport historii pojazdu jest powiązany z ogłoszeniem w Twoim zakresie; w przeciwnym razie false. Szczegółowe endpointy wyliczają ją ponownie na podstawie zwróconych vehicle_history_reports. Do odznaki dla konkretnego źródła użyj listings[].has_history_reports.

yearinteger
monthinteger
engine_volumeinteger
cylindersinteger
doorsinteger
seatsinteger
transmission_stepsinteger
power_hpinteger
battery_capacity_kwhnumber
vinstring
brandobject
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
modelobject
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
body_typeobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
transmissionobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
fuelobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
colorobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
market_originobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
drive_wheelsobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
emission_standardobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
steering_wheel_positionobjectmoże być null

1 = left (kierownica po lewej); 2 = right (kierownica po prawej). Odpowiedź to obiekt id/name; filtr wyszukiwania przyjmuje całkowite ID. Pomijane, gdy niedostępne, lub null, gdy zapisanej wartości nie można rozwiązać.

Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi

Jedno z: 1, 2.

namestringzawsze w odpowiedzi

Jedno z: left, right.

badgestring
created_atstring
updated_atstring
option_idsarray of integerzawsze w odpowiedzi
listingsarray of Listingzawsze w odpowiedzi
inspectionsarray of Inspection
vehicle_history_reportsarray of VehicleHistory
hashstringmoże być nullzawsze w odpowiedzi

SHA-256 zserializowanych danych pojazdu z wyłączeniem głównych created_at/updated_at oraz created_at/last_seen_at/updated_at ogłoszeń. Obejmuje location_details, więc dodanie tego pola lub zmiana lokalizowanych nazw może zmienić hash.

Samochód · wszystkie pola wypełnionePrzykład
{31 keys
"id": "example-car-021"
"has_inspections": true
"has_history_reports": true
"year": 2021
"month": 3
"vin": "EXAMPLEVIN0000021"
"brand": {2 keys
"id": 101
"name": "Example brand"
}
"model": {2 keys
"id": 201
"name": "Example SUV"
}
"badge": "2.0 Hybrid AWD Premium"
"engine_volume": 1999
"cylinders": 4
"doors": 5
"seats": 5
"transmission_steps": 8
"power_hp": 245
"battery_capacity_kwh": 1.6
"body_type": {2 keys
"id": 5
"name": "suv"
}
"transmission": {2 keys
"id": 1
"name": "automatic"
}
"fuel": {2 keys
"id": 3
"name": "hybrid"
}
"color": {2 keys
"id": 9
"name": "grey"
}
"market_origin": {2 keys
"id": 1
"name": "europe"
}
"drive_wheels": {2 keys
"id": 3
"name": "all"
}
"emission_standard": {2 keys
"id": 6
"name": "euro_6"
}
"steering_wheel_position": {2 keys
"id": 1
"name": "left"
}
"created_at": "2026-08-01T09:00:00Z"
"updated_at": "2026-09-28T06:00:00Z"
"option_ids": [6 items]
"listings": [2 items]
"inspections": [1 item]
"vehicle_history_reports": [1 item]
"hash": "3f1c9a0d7e5b2c48a61f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b"
}

Przykładowe wartości dobrane tak, aby pokazać każde pole. ID dla enumów, walut i lokalizacji są prawdziwe; nazwy, numery VIN i URL-e są zmyślone. Pole, którego nie widzisz w prawdziwej odpowiedzi, nie zostało dostarczone przez źródło.