{"openapi":"3.1.0","info":{"title":"HalDeFiyat API","version":"1","description":"Türkiye toptancı hal fiyatları. Ücretsizdir ve anahtar gerektirmez (kimlik doğrulama yok).\n\nKaynak bildirimi: her yanıt bir `attribution` alanı, her satır kendi kaynağını ve veri gününü taşır.\nBu, yukarı akış açık veri lisanslarının yeniden yayım koşuludur; veriyi gösterirken bildirimi de gösterin.\n\nİstek sınırı: IP başına dakikada 60 istek, tüm sunucularda ortak sayılır. Aşıldığında 429 ve Retry-After: 60.\n\nHata gövdesi: `{ error: {code, message, details, requestId}, code, message, requestId, timestamp }`.\nİç içe `error` nesnesi önceki sistemle uyumluluk için korunur. Kodlar UPPER_SNAKE yazılır.\n\nSayfalama: sayfalı uç noktalar `page` (1’den) ve `limit` alır; `meta.next` sonraki sayfanın göreli adresidir,\nson sayfada null. Aynı adres `Link: <…>; rel=\"next\"` başlığında da bulunur.\n\nTazelik (freshness): fresh | delayed | stale | failed | unavailable. Sitedeki kuralla aynı hesaplanır: kaynağın yayın takvimi\nve onaylı tatiller üzerinden kaçırılan yayın günü sayılır; iki güne kadar gecikme `delayed`, fazlası `stale`.\n`isStale` stale, failed ve unavailable için true döner. `dataDate` fiyatın ait olduğu gün, `fetchedAt` belgenin çekildiği andır.\nUyarı kodları: no_data, data_delayed, data_stale, source_frozen, source_blocked, source_unreachable, source_broken, last_fetch_failed, collection_paused, static_archive, computed_midpoint, corrected_value.\n\nÖnbellek: her uç noktanın süresi `x-cache` alanında ve Cache-Control başlığındadır. Fiyatlar günde bir kez değişir;\nyanıtları en az beş dakika saklayın ve ETag ile koşullu istek gönderin.\n\nCORS: salt okunur, anahtarsız ve kişisel veri taşımayan bir veri API’si olduğu için GET istekleri her kaynaktan\nkabul edilir (Access-Control-Allow-Origin: *). Hesap ve yönetim uç noktaları bu API’nin parçası değildir.\n\nHTML sayfalarını kazımak yerine bu API’yi kullanın. Kullanım politikası: /api-policy.","contact":{"url":"https://haldefiyat.com/iletisim"}},"servers":[{"url":"https://haldefiyat.com"}],"tags":[{"name":"Önceki sistemle uyumlu","description":"Önceki HalDeFiyat API’sinin yolları (sahibin listesi, R-API 52). Anahtar sırası ve tipleri korunur; yeni alanlar yalnızca sona eklenir."},{"name":"HalDeFiyat","description":"Bu sürümde eklenen uç noktalar"}],"paths":{"/api/v1/prices":{"get":{"operationId":"prices","summary":"Hal bazında fiyat satırları; her satır kaynağı, belge adresi ve tazelik durumuyla","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"product","in":"query","required":false,"schema":{"type":"string"},"description":"Ürün çeşidi ya da ürün kısa adı, örn. domates"},{"name":"market","in":"query","required":false,"schema":{"type":"string"},"description":"Hal kısa adı, örn. izmir-hal"},{"name":"city","in":"query","required":false,"schema":{"type":"string"},"description":"İl adı, örn. İzmir"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Kategori, örn. sebze, meyve"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Tek bir veri günü, YYYY-AA-GG"},{"name":"range","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+d$"},"description":"<gün>d biçiminde dönem, örn. 30d. Geçersiz değer 7 gün sayılır (eski sözleşme). En çok 3650d."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Sayfa numarası, 1’den başlar"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Sayfa boyu; uç noktanın üst sınırıyla kısılır"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"},"link":{"$ref":"#/components/headers/link"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricesResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"400":{"$ref":"#/components/responses/Error400"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":900,"staleWhileRevalidate":3600},"x-paginated":true}},"/api/v1/prices/latest":{"get":{"operationId":"prices_latest","summary":"Ürün başına en güncel ulusal gösterge; her satır kendi gününü taşır","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"product","in":"query","required":false,"schema":{"type":"string"},"description":"Ürün çeşidi ya da ürün kısa adı, örn. domates"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Kategori, örn. sebze, meyve"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":900,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/prices/history/{slug}":{"get":{"operationId":"prices_history_slug","summary":"Bir ürün çeşidinin hal bazında fiyat geçmişi (eski sözleşme: fiyatlar ondalık metin)","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":"Ürün çeşidi kısa adı"},{"name":"range","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+d$"},"description":"<gün>d biçiminde dönem, örn. 30d. Geçersiz değer 7 gün sayılır (eski sözleşme). En çok 3650d."},{"name":"market","in":"query","required":false,"schema":{"type":"string"},"description":"Hal kısa adı, örn. izmir-hal"},{"name":"bucket","in":"query","required":false,"schema":{"type":"string","enum":["daily","weekly","monthly","auto"]},"description":"daily | weekly | monthly | auto; geçersizse daily"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Sayfa numarası, 1’den başlar"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Sayfa boyu; uç noktanın üst sınırıyla kısılır"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"},"link":{"$ref":"#/components/headers/link"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":true}},"/api/v1/prices/markets":{"get":{"operationId":"prices_markets","summary":"Fiyat yayımlayan haller, kaynaklarıyla (eski adres; /api/v1/markets ile aynı yanıt)","tags":["Önceki sistemle uyumlu"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketsResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/prices/export":{"get":{"operationId":"prices_export","summary":"Fiyat satırları CSV olarak (BOM, virgül ayraç, nokta ondalık; locale=tr ile virgül ondalık)","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["csv"]},"description":"Yalnızca csv"},{"name":"product","in":"query","required":false,"schema":{"type":"string"},"description":"Ürün çeşidi ya da ürün kısa adı, örn. domates"},{"name":"market","in":"query","required":false,"schema":{"type":"string"},"description":"Hal kısa adı, örn. izmir-hal"},{"name":"city","in":"query","required":false,"schema":{"type":"string"},"description":"İl adı, örn. İzmir"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Kategori, örn. sebze, meyve"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Tek bir veri günü, YYYY-AA-GG"},{"name":"range","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+d$"},"description":"<gün>d biçiminde dönem, örn. 30d. Geçersiz değer 7 gün sayılır (eski sözleşme). En çok 3650d."},{"name":"latest","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"1 ise her ürün çeşidinin son bülteni"},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["tr"]},"description":"tr ise Türkçe Excel için virgül ondalık"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"CSV dosyası","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error400"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":0,"staleWhileRevalidate":0},"x-paginated":false}},"/api/v1/products":{"get":{"operationId":"products","summary":"Yayımdaki her ürün çeşidi ve en son göstergesi","tags":["HalDeFiyat"],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Kategori, örn. sebze, meyve"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Sayfa numarası, 1’den başlar"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Sayfa boyu; uç noktanın üst sınırıyla kısılır"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"},"link":{"$ref":"#/components/headers/link"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductsResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":true}},"/api/v1/products/search":{"get":{"operationId":"products_search","summary":"Ürün araması: ad ve kaynakların kullandığı adlar (alias) üzerinden, Türkçe katlamayla","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Aranan metin, en az iki harf"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"description":"En çok kaç sonuç (1–50, varsayılan 20)"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSearchResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"400":{"$ref":"#/components/responses/Error400"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":300,"staleWhileRevalidate":600},"x-paginated":false}},"/api/v1/products/{slug}/aliases":{"get":{"operationId":"products_slug_aliases","summary":"Bir ürün çeşidine bağlanmış kaynak adları: hangi hal hangi adı basıyor","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":"Ürün çeşidi (domates-pembe) ya da ürün ailesi (domates) kısa adı"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAliasesResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"404":{"$ref":"#/components/responses/Error404"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/markets":{"get":{"operationId":"markets","summary":"Yayımdaki her hal, kaynağı ve tazeliğiyle","tags":["HalDeFiyat"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketsResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/search":{"get":{"operationId":"search","summary":"Ürün ve hal araması, Türkçe katlamayla","tags":["HalDeFiyat"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Aranan metin"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"400":{"$ref":"#/components/responses/Error400"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":300,"staleWhileRevalidate":600},"x-paginated":false}},"/api/v1/sources/status":{"get":{"operationId":"sources_status","summary":"Her veri kaynağının durumu: son veri günü, son başarılı çekim, tazelik ve uyarılar","tags":["Önceki sistemle uyumlu"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourcesStatusResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":60,"staleWhileRevalidate":300},"x-paginated":false}},"/api/v1/index/latest":{"get":{"operationId":"index_latest","summary":"HalDeFiyat Endeksi: en son kapanmış hafta ve önceki haftaya göre değişim","tags":["Önceki sistemle uyumlu"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexLatestResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/index/history":{"get":{"operationId":"index_history","summary":"HalDeFiyat Endeksi haftalık serisi","tags":["Önceki sistemle uyumlu"],"parameters":[{"name":"range","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+d$"},"description":"Son <gün>d içindeki haftalar, örn. 90d; verilmezse tüm seri"},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Başlangıç günü, YYYY-AA-GG"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Bitiş günü, YYYY-AA-GG"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexHistoryResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"400":{"$ref":"#/components/responses/Error400"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/index/{slug}":{"get":{"operationId":"index_slug","summary":"Belediye verisinden hesaplanan, yayımlanmış bir endeks serisi; yayımlanmamışsa 409","tags":["HalDeFiyat"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":"Endeks kısa adı"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"404":{"$ref":"#/components/responses/Error404"},"409":{"$ref":"#/components/responses/Error409"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/observations/{id}":{"get":{"operationId":"observations_id","summary":"Bir fiyatın kanıtı: belge adresi, çekim anı, sha256, ayrıştırıcı sürümü, basıldığı satır","tags":["HalDeFiyat"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Gözlem kimliği (fiyat satırındaki id)"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservationResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"400":{"$ref":"#/components/responses/Error400"},"404":{"$ref":"#/components/responses/Error404"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":3600,"staleWhileRevalidate":3600},"x-paginated":false}},"/api/v1/health":{"get":{"operationId":"health","summary":"Kurulum durumu; bir kaynak takviminin gerisindeyse ya da uydurma veri modunda 503","tags":["HalDeFiyat"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"503":{"$ref":"#/components/responses/Error503"}},"security":[],"x-cache":{"sMaxAge":0,"staleWhileRevalidate":0},"x-paginated":false}},"/api/v1/search-index":{"get":{"operationId":"search_index","summary":"Sitedeki hızlı aramanın dizini: ürün, hal, şehir ve firma adları","tags":["HalDeFiyat"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchIndexResponse"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}},"security":[],"x-cache":{"sMaxAge":300,"staleWhileRevalidate":600},"x-paginated":false}},"/api/v1/openapi.json":{"get":{"operationId":"openapi_json","summary":"Bu OpenAPI 3.1 belgesi; yanıt şemalarından üretilir","tags":["HalDeFiyat"],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Başarılı","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"},"etag":{"$ref":"#/components/headers/etag"},"cache-control":{"$ref":"#/components/headers/cache-control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDocument"}}}},"304":{"description":"If-None-Match eşleşti; gövde yok","headers":{"etag":{"$ref":"#/components/headers/etag"},"x-request-id":{"$ref":"#/components/headers/x-request-id"}}},"429":{"$ref":"#/components/responses/Error429"}},"security":[],"x-cache":{"sMaxAge":300,"staleWhileRevalidate":600},"x-paginated":false}}},"components":{"schemas":{"ErrorResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"UPPER_SNAKE hata kodu"},"message":{"type":"string"},"details":{"anyOf":[{},{"type":"null"}]},"requestId":{"type":"string"}},"required":["code","message","details","requestId"],"additionalProperties":false,"description":"Eski sözleşmedeki iç içe gövde; uyumluluk için korunur"},"code":{"type":"string","description":"UPPER_SNAKE hata kodu, örn. NOT_FOUND, RATE_LIMITED, QUERY_TOO_SHORT"},"message":{"type":"string","description":"Türkçe açıklama"},"requestId":{"type":"string","description":"x-request-id başlığıyla aynı; hata bildirirken yazın"},"timestamp":{"type":"string","description":"ISO 8601 zaman damgası (UTC)"}},"required":["error","code","message","requestId","timestamp"],"additionalProperties":false,"description":"Hata gövdesi"},"PricesResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"minPrice":{"type":["number","null"]},"maxPrice":{"type":["number","null"]},"avgPrice":{"type":"number"},"avgPriceMethod":{"type":"string","enum":["reported","midpoint"]},"currency":{"type":"string"},"unit":{"type":"string"},"recordedDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"sourceApi":{"type":"string"},"productSlug":{"type":"string"},"productName":{"type":"string"},"categorySlug":{"type":"string"},"marketSlug":{"type":"string"},"marketName":{"type":"string"},"marketType":{"type":"string"},"cityName":{"type":"string"},"sourceName":{"type":"string"},"sourceUrl":{"type":"string","description":"Kaynağın yayın sayfası"},"isOfficialSource":{"type":"boolean"},"qualityFlags":{"type":"array","items":{"type":"string"}},"observed_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"source":{"type":"string"},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}},"documentUrl":{"description":"Bu satırın okunduğu belgenin tam adresi","type":["string","null"]},"observationUrl":{"type":"string","description":"Kanıt uç noktası: /api/v1/observations/{id}"}},"required":["id","minPrice","maxPrice","avgPrice","avgPriceMethod","currency","unit","recordedDate","sourceApi","productSlug","productName","categorySlug","marketSlug","marketName","marketType","cityName","sourceName","sourceUrl","isOfficialSource","qualityFlags","observed_date","source","dataDate","fetchedAt","isStale","freshness","warnings","documentUrl","observationUrl"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Bu sayfadaki kayıt sayısı"},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"description":"Filtreye uyan toplam kayıt; sayfa aralığın dışındaysa null","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"next":{"description":"Sonraki sayfanın göreli adresi; son sayfada null","type":["string","null"]},"rangeDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["count","limit","page","next"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["items","meta","attribution"],"additionalProperties":false},"LatestResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"unit":{"type":"string"},"observed_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"min":{"type":["number","null"]},"max":{"type":["number","null"]},"median":{"type":["number","null"]},"market_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}},"sources":{"type":"array","items":{"type":"string"},"description":"Bu ulusal medyana katkı veren kaynak kodları"}},"required":["slug","name","category","unit","observed_date","min","max","median","market_count"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"distinct_dates":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Kaç ayrı veri günü temsil ediliyor"},"newest":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"oldest":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"note":{"type":"string"}},"required":["count","distinct_dates","newest","oldest","note"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."},"warnings":{"description":"En yeni veri gününe göre genel uyarılar","type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}}},"required":["items","meta","attribution"],"additionalProperties":false},"HistoryResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"recordedDate":{"type":"string","description":"daily kovada tam ISO zaman damgası (eski sözleşme), diğerlerinde YYYY-MM-DD"},"minPrice":{"description":"Ondalık METİN, eski sözleşme gereği","type":["string","null"]},"maxPrice":{"type":["string","null"]},"avgPrice":{"type":["string","null"]},"avgPriceMethod":{"type":"string"},"unit":{"type":"string"},"marketSlug":{"type":"string"},"marketName":{"type":"string"},"cityName":{"type":["string","null"]},"source":{"type":"string"},"observed_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"productSlug":{"type":"string"},"productName":{"type":"string"},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}},"sourceUrl":{"type":["string","null"]},"documentUrl":{"type":["string","null"]}},"required":["recordedDate","minPrice","maxPrice","avgPrice","avgPriceMethod","unit","marketSlug","marketName","cityName","source","observed_date","productSlug","productName","dataDate","fetchedAt","isStale","freshness","warnings","sourceUrl","documentUrl"],"additionalProperties":false}},"meta":{"type":"object","properties":{"productSlug":{"type":"string"},"rangeDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bucket":{"type":"string"},"page":{"description":"Yalnızca page veya limit gönderildiğinde","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next":{"type":["string","null"]}},"required":["productSlug","rangeDays","bucket"],"additionalProperties":false,"description":"İlk üç anahtar eski sözleşmedir; sayfalama anahtarları yalnızca istendiğinde eklenir"},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["items","meta","attribution"],"additionalProperties":false},"MarketsResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"province":{"type":"string"},"district":{"type":["string","null"]},"kind":{"type":"string"},"source":{"type":"string"},"source_name":{"type":"string"},"organisation":{"type":"string"},"source_url":{"type":["string","null"]},"licence":{"type":["string","null"]},"status":{"type":"string"},"enabled":{"type":"boolean"},"expected_days":{"type":"string"},"last_observed_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"product_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}},"url":{"type":"string"}},"required":["slug","name","province","district","kind","source","source_name","organisation","source_url","licence","status","enabled","expected_days","last_observed_date","product_count","dataDate","fetchedAt","isStale","freshness","warnings","url"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["count"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["items","meta","attribution"],"additionalProperties":false},"ProductsResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"product":{"type":"string"},"category":{"type":"string"},"unit":{"type":["string","null"]},"observed_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Bu satırın verisinin ait olduğu gün"},"median":{"type":["number","null"]},"market_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"url":{"type":"string"},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}}},"required":["slug","name","category","unit","observed_date"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["count"],"additionalProperties":{}},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["items","meta","attribution"],"additionalProperties":false},"ProductSearchResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"normalised":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"product":{"type":"string"},"category":{"type":"string"},"unit":{"type":["string","null"]},"observed_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"matched":{"type":"string","enum":["name","alias"],"description":"Eşleşme ürün adından mı, kaynak adından (alias) mı"},"alias":{"description":"Eşleşen kaynak adı, alias ile eşleştiyse","type":["string","null"]},"url":{"type":"string"},"aliases_url":{"type":"string"}},"required":["slug","name","product","category","unit","observed_date","matched","alias","url","aliases_url"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["count","limit"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["query","normalised","items","meta","attribution"],"additionalProperties":false},"ProductAliasesResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"product":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"url":{"type":"string"}},"required":["slug","name","category","url"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"source_name":{"type":"string"},"raw_name":{"type":"string","description":"Kaynağın bastığı ad, olduğu gibi"},"match_key":{"type":"string","description":"Türkçe katlanmış anahtar"},"unit":{"type":["string","null"]},"method":{"description":"exact | trigram | manual | seed","type":["string","null"]},"confidence":{"description":"pg_trgm benzerliği, 0–1; karar değil okuma yardımı","type":["number","null"]},"reviewed_at":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}]},"variant":{"type":"string","description":"Adın bağlı olduğu ürün çeşidi"}},"required":["source","source_name","raw_name","match_key","unit","method","confidence","reviewed_at","variant"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"note":{"type":"string"}},"required":["count","note"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["product","items","meta","attribution"],"additionalProperties":false},"SearchResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"normalised":{"type":"string","description":"Türkçe katlanmış arama anahtarı; ingest ile aynı fonksiyon"},"products":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"unit":{"type":["string","null"]},"observed_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"url":{"type":"string"}},"required":["slug","name","category","unit","observed_date","url"],"additionalProperties":false}},"markets":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"province":{"type":"string"},"url":{"type":"string"}},"required":["slug","name","province","url"],"additionalProperties":false}},"meta":{"type":"object","properties":{"products":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["products","markets","limit"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["query","normalised","products","markets","meta","attribution"],"additionalProperties":false},"SourcesStatusResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"organisation":{"type":"string"},"kind":{"type":"string"},"url":{"type":["string","null"]},"licence":{"type":["string","null"]},"attribution":{"type":"string"},"expected_days":{"type":"string"},"publish_window":{"type":["string","null"]},"enabled":{"type":"boolean","description":"Otomatik toplamaya açık mı"},"status":{"type":"string","description":"unverified | verified | blocked | unreachable | broken | frozen"},"health":{"type":"string","enum":["healthy","delayed","warning","failed","off"]},"health_label":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"last_success_at":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}]},"product_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"publishingDaysBehind":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}}},"required":["key","name","organisation","kind","url","licence","attribution","expected_days","publish_window","enabled","status","health","health_label","reasons","last_success_at","product_count","publishingDaysBehind","dataDate","fetchedAt","isStale","freshness","warnings"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked_at":{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},"scheduler_seen_at":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Zamanlayıcının son çalıştığı an; null ise barındırılan toplama henüz görülmedi"},"note":{"type":"string"}},"required":["count","enabled","checked_at","scheduler_seen_at","note"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["items","meta","attribution"],"additionalProperties":false},"IndexLatestResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"index":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"method":{"type":"string"},"base_week":{"type":["string","null"]},"base_value":{"type":"number"},"source":{"type":"string"}},"required":["slug","name","method","base_week","base_value","source"],"additionalProperties":false},"latest":{"anyOf":[{"type":"object","properties":{"week":{"type":"string","description":"ISO hafta, YYYY-WW"},"week_start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"week_end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"value":{"type":"number"},"member_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"previous_value":{"type":["number","null"]},"change":{"description":"Önceki haftaya göre oran (0,012 = %1,2)","type":["number","null"]}},"required":["week","week_start","week_end","value","member_count","previous_value","change"],"additionalProperties":false},{"type":"null"}]},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}},"municipal":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"published":{"type":"boolean"},"weeks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["slug","name","published","weeks"],"additionalProperties":false},"description":"Belediye verisinden hesaplanacak endeks tanımları; yayımlanmamışsa değer verilmez"},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["index","latest","dataDate","fetchedAt","isStale","freshness","warnings","municipal","attribution"],"additionalProperties":false},"IndexHistoryResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"index":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"base_week":{"type":["string","null"]},"source":{"type":"string"}},"required":["slug","name","base_week","source"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"week":{"type":"string","description":"ISO hafta, YYYY-WW"},"week_start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"week_end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"value":{"type":"number"},"member_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["week","week_start","week_end","value","member_count"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"from":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"to":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]}},"required":["count","from","to"],"additionalProperties":false},"dataDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}],"description":"Fiyatın ait olduğu gün (kaynağın kendi tarihi)"},"fetchedAt":{"anyOf":[{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},{"type":"null"}],"description":"Belgenin kaynaktan çekildiği an; veri gününden farklıdır"},"isStale":{"type":"boolean","description":"freshness stale, failed veya unavailable ise true"},"freshness":{"type":"string","enum":["fresh","delayed","stale","failed","unavailable"],"description":"fresh: veri günü bugün ya da kaynak o günden beri yayın günü geçirmedi · delayed: bir-iki yayın günü gecikme (sitedeki tolerans içinde) · stale: ikiden fazla yayın günü kaçırıldı, kaynak donmuş ya da durağan arşiv · failed: kaynak engellendi/erişilemiyor/bozuk ya da son çekim başarısız ve veri güncel değil · unavailable: veri günü yok"},"warnings":{"type":"array","items":{"type":"string","enum":["no_data","data_delayed","data_stale","source_frozen","source_blocked","source_unreachable","source_broken","last_fetch_failed","collection_paused","static_archive","computed_midpoint","corrected_value"],"description":"Makine tarafından okunabilir uyarı kodu"}},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["index","items","meta","dataDate","fetchedAt","isStale","freshness","warnings","attribution"],"additionalProperties":false},"IndexResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"method":{"type":"string","description":"Hesap yöntemi, sayfada yazdığı hâliyle"},"base_week_start":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"base_value":{"type":"number"},"methodology_note":{"type":["string","null"]},"values":{"type":"array","items":{"type":"object","properties":{"week_start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"value":{"type":"number"},"member_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["week_start","value","member_count"],"additionalProperties":false}},"meta":{"type":"object","properties":{"weeks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["weeks"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["slug","name","version","method","base_week_start","base_value","methodology_note","values","meta","attribution"],"additionalProperties":false},"ObservationResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"observation":{"type":"object","properties":{"id":{"type":"string"},"product":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"market":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"observed_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},"unit":{"type":"string"},"price_min":{"type":["number","null"]},"price_max":{"type":["number","null"]},"price_avg":{"type":["number","null"]},"price_mid":{"type":["number","null"]},"quality":{"type":"string"},"quality_reason":{"type":"array","items":{"type":"string"}},"superseded_by":{"type":["string","null"]},"corrected_at":{"type":["string","null"]},"correction_reason":{"type":["string","null"]}},"required":["id","product","market","observed_date","unit","price_min","price_max","price_avg","price_mid","quality","quality_reason","superseded_by","corrected_at","correction_reason"],"additionalProperties":false},"as_published":{"type":"object","properties":{"raw_name":{"type":"string"},"raw_unit":{"type":["string","null"]},"line_ref":{"type":"string"}},"required":["raw_name","raw_unit","line_ref"],"additionalProperties":false},"provenance":{"type":"object","properties":{"source":{"type":"string"},"source_name":{"type":"string"},"organisation":{"type":"string"},"licence":{"type":["string","null"]},"url":{"type":"string"},"fetched_at":{"type":"string","description":"ISO 8601 zaman damgası (UTC)"},"bulletin_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD, Europe/Istanbul takvim günü"},{"type":"null"}]},"sha256":{"type":["string","null"]},"parser_version":{"type":["string","null"]},"artefact":{"anyOf":[{"type":"object","properties":{"available":{"type":"boolean"},"request_via":{"type":"string"}},"required":["available","request_via"],"additionalProperties":false},{"type":"null"}]}},"required":["source","source_name","organisation","licence","url","fetched_at","bulletin_date","sha256","parser_version","artefact"],"additionalProperties":false},"attribution":{"type":"string","minLength":1,"description":"Kaynak bildirimi. İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar."}},"required":["observation","as_published","provenance","attribution"],"additionalProperties":false},"HealthResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string"},"mode":{"type":"string","enum":["real","synthetic"]},"checks":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["status","mode"],"additionalProperties":{},"description":"ETL_MODE synthetic iken 503 döner: uydurma veri sunan bir kurulum sağlıklı değildir"},"SearchIndexResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"number","const":1},"entries":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"},"href":{"type":"string"},"subtitle":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}}},"required":["kind","label","value","href"],"additionalProperties":false}}},"required":["version","entries"],"additionalProperties":false,"description":"Tarayıcı içi arama dizini: yalnızca herkese açık kimlikler (ürün, hal, şehir, firma adı)"},"OpenApiDocument":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"openapi":{"type":"string"},"info":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"paths":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["openapi","info","paths"],"additionalProperties":{},"description":"Bu belge"}},"parameters":{"RequestId":{"name":"x-request-id","in":"header","required":false,"description":"İsteğe bağlı kendi kimliğiniz (8–128 karakter, harf/rakam ve ._:-). Geçerliyse yanıtta aynen döner; değilse sunucu bir UUID üretir.","schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$"}}},"headers":{"x-request-id":{"description":"Bu isteğin kimliği. Hata bildirirken yazın. Önbellekten gelen yanıtta, yanıtı üreten isteğin kimliğidir.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Dakikalık istek hakkı","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Bu dakikada kalan istek","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Pencerenin sıfırlandığı an, Unix saniyesi","schema":{"type":"integer"}},"etag":{"description":"Gövdenin özeti; If-None-Match ile gönderirseniz değişmemiş veri için 304 döner","schema":{"type":"string"}},"cache-control":{"description":"Uç noktaya özgü önbellek süresi (x-cache)","schema":{"type":"string"}},"link":{"description":"Sayfalı uç noktalarda sonraki sayfa: <…>; rel=\"next\"","schema":{"type":"string"}}},"responses":{"Error400":{"description":"Geçersiz parametre (örn. INVALID_DATE, QUERY_TOO_SHORT, BAD_REQUEST)","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Error404":{"description":"Kayıt yok (NOT_FOUND)","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Error409":{"description":"Kayıt var ama yayımlanabilir durumda değil (NOT_PUBLISHED, TOO_FEW_WEEKS)","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Error429":{"description":"Dakikalık istek sınırı aşıldı (RATE_LIMITED); Retry-After: 60","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-ratelimit-limit":{"$ref":"#/components/headers/x-ratelimit-limit"},"x-ratelimit-remaining":{"$ref":"#/components/headers/x-ratelimit-remaining"},"x-ratelimit-reset":{"$ref":"#/components/headers/x-ratelimit-reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Error500":{"description":"Beklenmeyen hata (INTERNAL_ERROR); gövdedeki requestId ile bildirin","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Error503":{"description":"Kurulum sağlıklı değil (uydurma veri ya da geciken kaynak)","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}