Models
# Araç Modelleri
Verilen marka ve yıla ait model listesini **fiyat bilgisiyle** sayfalı döner. Sonuç 24 saat cache'lenir.
## Uç Nokta (Endpoint)
`GET {{baseUrl}}/api/Vehicles/{brand}/{year}`
## Kimlik Doğrulama
Üst koleksiyondan miras alınan **Bearer Token** kullanılır; token `{{authToken}}` değişkeninden çözümlenir ve ilgili rolde **Read** yetkisi gerektirir.
## Path Parametreleri
| Parametre | Tip | Zorunlu | Açıklama |
| --- | --- | --- | --- |
| brand | string | ✅ | Marka değeri (ör. 009). |
| year | integer | ✅ | Model yılı. Geçersiz yıl değerinde **400** döner. |
## Sorgu Parametreleri
| Parametre | Tip | Zorunlu | Varsayılan | Açıklama |
| --- | --- | --- | --- | --- |
| query | string | ❌ | (boş) | Model arama metni. |
| page | integer | ❌ | 1 | Sayfa numarası. 1'den küçük gönderilirse 1'e sabitlenir. |
| pagesize | integer | ❌ | 100 | Sayfa başına kayıt. Maksimum 100. |
## Örnek İstek
```
GET {{baseUrl}}/api/Vehicles/RENAULT/2024?query=&page=1&pagesize=100
```
## Yanıt Yapısı
### Başarılı Yanıt (200 OK)
``` json
{
"Data": [
{ "ParameterId": 42, "Text": "Clio", "Value": "RENAULT_CLIO_2024", "Crossed": false, "Status": true, "Price": "850000" }
],
"Page": 1,
"PageSize": 100,
"TotalCount": 2
}
```
## **Response Parametreleri:**
| **Alan** | **Tip** | **Açıklama** |
| --- | --- | --- |
| Data | array | `VehicleWithPriceDTO` listesi. |
| Page | integer | Mevcut sayfa numarası. |
| PageSize | integer | Sayfa başına kayıt sayısı. |
| TotalCount | integer | Toplam kayıt sayısı. |
Data:
| **Alan** | **Tip** | **Açıklama** |
| --- | --- | --- |
| ParameterId | integer | Parametre Id. |
| Text | string | Model görünen adı. |
| Value | string | Model kodu. |
| Crossed | boolean | Cross (kapatma) durumu. |
| Status | boolean | Aktif/pasif. |
| Price | string | Model referans fiyatı. |
## Hata Yanıtları
**400 Bad Request (geçersiz yıl)** — Yıl doğrulamasından geçemeyen değerler için kontrolör doğrudan düz metin mesaj döner:
```
1800 değeri yil için geçersizdir.
```
**400 Bad Request (genel)**
```
İşlem sırasında bir hata oluştu! RequestId: 0HN1GPVL2F3Q0:00000007, LogId: 9f8e7d6c5b4a
```
| Durum Kodu | Gövde | Açıklama |
| --- | --- | --- |
| 401 Unauthorized | (boş) | Token yok / geçersiz / süresi dolmuş. |
| 403 Forbidden | (boş) | Rol bu uç için Read yetkisine sahip değil veya IP beyaz listede değil. |
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
brand
year
Headers
Accept
Query parameters
query
Model arama metni. Opsiyonel.
page
pagesize
Response headers
Transfer-Encoding
Content-Type
Content-Encoding
Vary
X-Frame-Options
X-XSS-Protection
X-Content-Type-Options
Referrer-Policy
X-Powered-By
Date
Response
OK
