{"openapi":"3.1.0","info":{"title":"VeriApi.Pro","description":"Türkiye için tek anahtarlı veri API'si.\n\n**Kimlik:** her istekte `X-API-Key: va_…` başlığı (ya da `?anahtar=`). Günlük kota istek birimiyle düşer (çoğu uç 1, bazıları 2/5/10; isteğin maliyeti `X-Istek-Maliyeti` başlığında), kalan kota `X-RateLimit-*` başlıklarında.\n\n**Yanıt:** `{\"veri\": …, \"kaynak\": [...], \"guncelleme\": \"…\", \"bayat\": false}`. `kaynak` alanındaki atıf metni,\nveriyi gösterdiğiniz yerde görünür olmalıdır (CC BY lisansları gereği). `bayat: true` → kaynak şu an\ngüncellenemiyor, son iyi değer dönüyor.\n\n**Hata:** `{\"hata\": {\"kod\": 404, \"mesaj\": \"…\"}}`.\n","version":"0.1.0"},"paths":{"/v1/konumlar/iller":{"get":{"summary":"81 il","operationId":"konumlar_iller","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/konumlar/iller/{il}/ilceler":{"get":{"summary":"İlin ilçeleri","operationId":"konumlar_iller_il_ilceler","parameters":[{"name":"il","in":"path","required":true,"schema":{"type":"string","title":"Il"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/bul":{"get":{"summary":"Konum çöz (slug, il/ilçe ya da en yakın koordinat)","operationId":"konumlar_bul","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/namaz":{"get":{"summary":"Namaz vakitleri, iftar ve sahur (Diyanet yöntemiyle hesap)","operationId":"namaz","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Başlangıç (YYYY-AA-GG), varsayılan bugün","title":"Tarih"},"description":"Başlangıç (YYYY-AA-GG), varsayılan bugün"},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":31,"minimum":1,"description":"Gün sayısı (en çok 31)","default":1,"title":"Gun"},"description":"Gün sayısı (en çok 31)"},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/gunes":{"get":{"summary":"Güneş doğuş / batış, gün uzunluğu (astronomik, temkinsiz)","operationId":"gunes","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Tarih"}},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":31,"minimum":1,"default":1,"title":"Gun"}},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hava":{"get":{"summary":"Anlık hava, 24 saatlik ve 7 günlük tahmin","operationId":"hava","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deprem/son":{"get":{"summary":"Son depremler (Türkiye ve çevresi, son 7 gün)","operationId":"deprem_son","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"min_buyukluk","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10,"minimum":0},{"type":"null"}],"description":"En küçük büyüklük","title":"Min Buyukluk"},"description":"En küçük büyüklük"},{"name":"saat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":168,"minimum":1},{"type":"null"}],"description":"Son kaç saat","title":"Saat"},"description":"Son kaç saat"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"En yakın ili bu olan depremler (ad, slug ya da plaka)","title":"Il"},"description":"En yakın ili bu olan depremler (ad, slug ya da plaka)"},{"name":"yurtici","in":"query","required":false,"schema":{"type":"boolean","description":"Yalnızca Türkiye'deki bir konuma 150 km içindekiler","default":false,"title":"Yurtici"},"description":"Yalnızca Türkiye'deki bir konuma 150 km içindekiler"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/doviz":{"get":{"summary":"Döviz kurları (TRY karşılığı; anlık Kapalıçarşı ya da merkez bankası referans)","operationId":"doviz","parameters":[{"name":"kod","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle kodlar (ör. USD,EUR,GBP)","title":"Kod"},"description":"Virgülle kodlar (ör. USD,EUR,GBP)"},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(anlik|referans)$","description":"anlik: Kapalıçarşı, dakikada bir; referans: ECB gün sonu","default":"anlik","title":"Tur"},"description":"anlik: Kapalıçarşı, dakikada bir; referans: ECB gün sonu"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/tatiller":{"get":{"summary":"Resmî tatiller ve dini bayramlar","operationId":"takvim_tatiller","parameters":[{"name":"yil","in":"query","required":false,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Yıl, varsayılan bu yıl","title":"Yil"},"description":"Yıl, varsayılan bu yıl"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/gun":{"get":{"summary":"Gün bilgisi: hafta numarası, iş günü, tatil","operationId":"takvim_gun","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Tarih"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mevzuat/asgari-ucret":{"get":{"summary":"Asgari ücret (brüt, net, günlük)","operationId":"mevzuat_asgari_ucret","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mevzuat/gelir-vergisi":{"get":{"summary":"Gelir vergisi tarifesi; matrah verilirse vergi hesabı","operationId":"mevzuat_gelir_vergisi","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"title":"Yil"}},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(ucret|diger)$","description":"ucret: ücret gelirleri, diger: ücret dışı","default":"ucret","title":"Tur"},"description":"ucret: ücret gelirleri, diger: ücret dışı"},{"name":"matrah","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000000.0,"minimum":0},{"type":"null"}],"description":"Yıllık vergi matrahı (TL)","title":"Matrah"},"description":"Yıllık vergi matrahı (TL)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mevzuat/kdv":{"get":{"summary":"KDV oranları","operationId":"mevzuat_kdv","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/ekonomi/enflasyon":{"get":{"summary":"TÜFE: endeks, aylık, yıllık ve 12 aylık ortalama değişim","operationId":"ekonomi_enflasyon","parameters":[{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"description":"Kaç ay geriye (en çok 60)","default":24,"title":"Ay"},"description":"Kaç ay geriye (en çok 60)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mevzuat/kira-artisi":{"get":{"summary":"Kira artış sınırı (TÜFE 12 aylık ortalama değişim, TBK m.344)","operationId":"mevzuat_kira_artisi","parameters":[{"name":"yenileme","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},{"type":"null"}],"description":"Sözleşmenin yenilendiği ay (YYYY-AA); boşsa en güncel","title":"Yenileme"},"description":"Sözleşmenin yenilendiği ay (YYYY-AA); boşsa en güncel"},{"name":"kira","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"Mevcut aylık kira (TL); verilirse yeni azami kira","title":"Kira"},"description":"Mevcut aylık kira (TL); verilirse yeni azami kira"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/saat":{"get":{"summary":"Bir şehrin ya da saat diliminin yerel saati, UTC ve Türkiye farkı","operationId":"saat","parameters":[{"name":"sehir","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Şehir (ör. londra, new-york)","title":"Sehir"},"description":"Şehir (ör. londra, new-york)"},{"name":"bolge","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IANA bölgesi (ör. Europe/London)","title":"Bolge"},"description":"IANA bölgesi (ör. Europe/London)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/saat/sehirler":{"get":{"summary":"Tanımlı şehirler ve şu anki yerel saatleri","operationId":"saat_sehirler","parameters":[{"name":"ulke","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ülke kodu (ör. DE)","title":"Ulke"},"description":"Ülke kodu (ör. DE)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulkeler":{"get":{"summary":"Ülkeler: ISO kodları, başkent, para birimi, telefon kodu","operationId":"ulkeler","parameters":[{"name":"kita","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kıta (ör. Avrupa)","title":"Kita"},"description":"Kıta (ör. Avrupa)"},{"name":"para","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Para birimi kodu (ör. EUR)","title":"Para"},"description":"Para birimi kodu (ör. EUR)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulkeler/{kod}":{"get":{"summary":"Tek ülke (ISO2, ISO3, sayısal kod ya da ad)","operationId":"ulkeler_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cevir/doviz":{"get":{"summary":"Döviz çevirici (anlık Kapalıçarşı ya da referans kurla, TRY dahil)","operationId":"cevir_doviz","parameters":[{"name":"miktar","in":"query","required":true,"schema":{"type":"number","maximum":1000000000000000.0,"minimum":0,"title":"Miktar"}},{"name":"kaynak","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":3,"title":"Kaynak"}},{"name":"hedef","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":3,"title":"Hedef"}},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(anlik|referans)$","default":"anlik","title":"Tur"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cevir/birim":{"get":{"summary":"Birim çevirici (uzunluk, kütle, alan, hacim, hız, sıcaklık)","operationId":"cevir_birim","parameters":[{"name":"miktar","in":"query","required":true,"schema":{"type":"number","maximum":1000000000000000.0,"minimum":-1000000000000000.0,"title":"Miktar"}},{"name":"kaynak","in":"query","required":true,"schema":{"type":"string","title":"Kaynak"}},{"name":"hedef","in":"query","required":true,"schema":{"type":"string","title":"Hedef"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cevir/birimler":{"get":{"summary":"Desteklenen birimler","operationId":"cevir_birimler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mevzuat/isveren-maliyeti":{"get":{"summary":"Brüt ücretin işveren maliyeti (SGK + işsizlik, teşvikli/teşviksiz)","operationId":"mevzuat_isveren_maliyeti","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yil"}},{"name":"brut","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"Varsayılan: asgari ücret","title":"Brut"},"description":"Varsayılan: asgari ücret"},{"name":"tesvik","in":"query","required":false,"schema":{"type":"string","pattern":"^(yok|genel|imalat)$","default":"yok","title":"Tesvik"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mevzuat/yeniden-degerleme":{"get":{"summary":"Yeniden değerleme oranı (VUK)","operationId":"mevzuat_yeniden_degerleme","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulasim/kopruler":{"get":{"summary":"Köprü geçiş ücretleri (araç sınıfına göre)","operationId":"ulasim_kopruler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/takvim/dini-gunler":{"get":{"summary":"Kandiller, Ramazan başlangıcı, hicri yılbaşı, Aşure ve dini bayramlar","operationId":"takvim_dini_gunler","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/hicri":{"get":{"summary":"Miladi tarihin hicri karşılığı","operationId":"takvim_hicri","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Miladi tarih (YYYY-AA-GG), varsayılan bugün","title":"Tarih"},"description":"Miladi tarih (YYYY-AA-GG), varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/miladi":{"get":{"summary":"Hicri tarihin miladi karşılığı","operationId":"takvim_miladi","parameters":[{"name":"yil","in":"query","required":true,"schema":{"type":"integer","maximum":1600,"minimum":1300,"description":"Hicri yıl (ör. 1448)","title":"Yil"},"description":"Hicri yıl (ör. 1448)"},{"name":"ay","in":"query","required":true,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"Hicri ay (1 Muharrem … 12 Zilhicce)","title":"Ay"},"description":"Hicri ay (1 Muharrem … 12 Zilhicce)"},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":1,"title":"Gun"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/hicri-yil":{"get":{"summary":"Hicri yılın ay başları ve gün sayıları","operationId":"takvim_hicri_yil","parameters":[{"name":"yil","in":"query","required":true,"schema":{"type":"integer","maximum":1600,"minimum":1300,"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/ilceler/{ilce}/yerler":{"get":{"summary":"İlçenin mahalle ve köyleri (Wikidata; kapsam eksik olabilir)","operationId":"konumlar_ilceler_ilce_yerler","parameters":[{"name":"ilce","in":"path","required":true,"schema":{"type":"string","title":"Ilce"}},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(mahalle|koy)$"},{"type":"null"}],"title":"Tur"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/yerler/ara":{"get":{"summary":"Mahalle / köy ara","operationId":"konumlar_yerler_ara","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"title":"Q"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(mahalle|koy)$"},{"type":"null"}],"title":"Tur"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/altin/turler":{"get":{"summary":"Altın türleri: ağırlık, ayar (milyem), saf altın içeriği","operationId":"altin_turler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/altin":{"get":{"summary":"Altın fiyatları (alış, satış, değişim)","operationId":"altin","parameters":[{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle türler (ör. gram,ceyrek)","title":"Tur"},"description":"Virgülle türler (ör. gram,ceyrek)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/altin/hesapla":{"get":{"summary":"Teorik değer: adet × saf altın × has gram fiyatı","operationId":"altin_hesapla","parameters":[{"name":"tur","in":"query","required":true,"schema":{"type":"string","description":"Tür kodu (ör. ceyrek)","title":"Tur"},"description":"Tür kodu (ör. ceyrek)"},{"name":"adet","in":"query","required":false,"schema":{"type":"number","maximum":1000000.0,"exclusiveMinimum":0,"default":1,"title":"Adet"}},{"name":"has_fiyat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"description":"Has altın gram fiyatı (TL); boşsa kaynaktan","title":"Has Fiyat"},"description":"Has altın gram fiyatı (TL); boşsa kaynaktan"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/akaryakit":{"get":{"summary":"İl bazında benzin, motorin, LPG ve diğer yakıtlar (dağıtıcı bazında)","operationId":"akaryakit","parameters":[{"name":"il","in":"query","required":true,"schema":{"type":"string","description":"İl adı, slug'ı ya da plaka","title":"Il"},"description":"İl adı, slug'ı ya da plaka"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle yakıt kodları (ör. benzin,motorin,otogaz)","title":"Tur"},"description":"Virgülle yakıt kodları (ör. benzin,motorin,otogaz)"},{"name":"dagitici","in":"query","required":false,"schema":{"type":"boolean","description":"Dağıtıcı listesi dahil","default":true,"title":"Dagitici"},"description":"Dağıtıcı listesi dahil"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/akaryakit/turkiye":{"get":{"summary":"Türkiye ortalaması (en yüksek hacimli 8 dağıtıcı)","operationId":"akaryakit_turkiye","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/akaryakit/gecmis":{"get":{"summary":"İlin günlük ortalama fiyat geçmişi (toplama başladığımız günden itibaren)","operationId":"akaryakit_gecmis","parameters":[{"name":"il","in":"query","required":true,"schema":{"type":"string","title":"Il"}},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":366,"minimum":1,"default":30,"title":"Gun"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/elektrik/tarife":{"get":{"summary":"Elektrik tarifeleri (EPDK onaylı; abone grubu, tek / çok zamanlı)","operationId":"elektrik_tarife","parameters":[{"name":"grup","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"mesken, ticarethane, sanayi, tarimsal, aydinlatma","title":"Grup"},"description":"mesken, ticarethane, sanayi, tarimsal, aydinlatma"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dogalgaz/tarife":{"get":{"summary":"Doğalgaz tarifeleri (BOTAŞ toptan + dağıtım şirketleri)","operationId":"dogalgaz_tarife","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/ulasim/otoyol":{"get":{"summary":"Otoyol, köprü ve tünel ücretleri (araç sınıfına göre)","operationId":"ulasim_otoyol","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/altin/gecmis":{"get":{"summary":"Altın fiyat geçmişi (günlük; kaynak bağlanınca dolar)","operationId":"altin_gecmis","parameters":[{"name":"tur","in":"query","required":false,"schema":{"type":"string","default":"gram","title":"Tur"}},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":3660,"minimum":1,"default":30,"title":"Gun"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/mahalleler":{"get":{"summary":"İl/ilçe → mahalle ve köyler (kısayol)","operationId":"konumlar_mahalleler","parameters":[{"name":"il","in":"query","required":true,"schema":{"type":"string","title":"Il"}},{"name":"ilce","in":"query","required":true,"schema":{"type":"string","title":"Ilce"}},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(mahalle|koy)$"},{"type":"null"}],"title":"Tur"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/piyasa/fiyat":{"get":{"tags":["piyasa"],"summary":"Anlık fiyatlar (alış, satış, günlük değişim)","operationId":"piyasa_fiyat","parameters":[{"name":"sembol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle kod ya da sembol (ör. USD,GRAM,BTCUSDT); en çok 100","title":"Sembol"},"description":"Virgülle kod ya da sembol (ör. USD,GRAM,BTCUSDT); en çok 100"},{"name":"grup","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(doviz|altin|metal|parite|emtia|kripto)$"},{"type":"null"}],"description":"Hazır grup: doviz, altin, metal, parite, emtia, kripto","title":"Grup"},"description":"Hazır grup: doviz, altin, metal, parite, emtia, kripto"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/piyasa/semboller":{"get":{"tags":["piyasa"],"summary":"Canlı semboller ve hazır kodlar","operationId":"piyasa_semboller","parameters":[{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"doviz, emtia, kripto, hisse, endeks","title":"Tur"},"description":"doviz, emtia, kripto, hisse, endeks"},{"name":"ara","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"description":"Sembol ya da adda arama","title":"Ara"},"description":"Sembol ya da adda arama"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/piyasa/grafik":{"get":{"tags":["piyasa"],"summary":"Mum (OHLC) verisi: 15 dk, 1 saat, 1 gün","operationId":"piyasa_grafik","parameters":[{"name":"sembol","in":"query","required":true,"schema":{"type":"string","description":"Hazır kod ya da sembol (ör. GRAM, USDTRY_HRM)","title":"Sembol"},"description":"Hazır kod ya da sembol (ör. GRAM, USDTRY_HRM)"},{"name":"aralik","in":"query","required":false,"schema":{"type":"string","pattern":"^(15m|1h|1d)$","description":"15m (son 24 saat), 1h (7 gün), 1d (1 yıl)","default":"1h","title":"Aralik"},"description":"15m (son 24 saat), 1h (7 gün), 1d (1 yıl)"},{"name":"adet","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"description":"Son kaç mum","title":"Adet"},"description":"Son kaç mum"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/piyasa/hareketliler":{"get":{"tags":["piyasa"],"summary":"Günün en çok yükselen, düşen ve en hareketli enstrümanları","operationId":"piyasa_hareketliler","parameters":[{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(tumu|doviz|emtia|kripto|hisse|endeks)$","default":"tumu","title":"Tur"}},{"name":"liste","in":"query","required":false,"schema":{"type":"string","pattern":"^(yukselen|dusen|aktif)$","default":"yukselen","title":"Liste"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/piyasa/ozet":{"get":{"tags":["piyasa"],"summary":"Piyasa özeti: yükselen / düşen / değişmeyen sayısı","operationId":"piyasa_ozet","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/piyasa/takvim":{"get":{"tags":["piyasa"],"summary":"Ekonomik takvim (Türkiye tümü; diğer ülkelerde önemi yüksek ve orta olaylar)","operationId":"piyasa_takvim","parameters":[{"name":"ulke","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle ülke kodları (ör. TR,US); boşsa hepsi","title":"Ulke"},"description":"Virgülle ülke kodları (ör. TR,US); boşsa hepsi"},{"name":"onem","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(yuksek|orta|dusuk)$"},{"type":"null"}],"description":"En az bu önemde","title":"Onem"},"description":"En az bu önemde"},{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"YYYY-AA-GG, varsayılan bugün","title":"Baslangic"},"description":"YYYY-AA-GG, varsayılan bugün"},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":45,"minimum":1,"description":"Kaç gün","default":7,"title":"Gun"},"description":"Kaç gün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/piyasa/takvim/ulkeler":{"get":{"tags":["piyasa"],"summary":"Ekonomik takvimdeki ülkeler","operationId":"piyasa_takvim_ulkeler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/piyasa/haberler":{"get":{"tags":["piyasa"],"summary":"Piyasa haberleri (başlık, yayıncı, bağlantı)","operationId":"piyasa_haberler","parameters":[{"name":"dil","in":"query","required":false,"schema":{"type":"string","pattern":"^(tr|en)$","default":"tr","title":"Dil"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kripto":{"get":{"tags":["kripto"],"summary":"Kripto paralar: USD ve TL fiyatı, günlük değişim","operationId":"kripto","parameters":[{"name":"kod","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle coin kodları (ör. BTC,ETH,SOL); en çok 100","title":"Kod"},"description":"Virgülle coin kodları (ör. BTC,ETH,SOL); en çok 100"},{"name":"ara","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"description":"Kod ya da adda arama","title":"Ara"},"description":"Kod ya da adda arama"},{"name":"sirala","in":"query","required":false,"schema":{"type":"string","pattern":"^(sira|degisim|dusen|ad)$","description":"sira (piyasa değerine yakın sıra), degisim (en çok yükselen), dusen, ad","default":"sira","title":"Sirala"},"description":"sira (piyasa değerine yakın sıra), degisim (en çok yükselen), dusen, ad"},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kripto/hesapla":{"get":{"tags":["kripto"],"summary":"Kripto tutarının USD ve TL karşılığı (ya da TL / USD tutarının kaç coin ettiği)","operationId":"kripto_hesapla","parameters":[{"name":"kod","in":"query","required":true,"schema":{"type":"string","description":"Coin kodu (ör. BTC)","title":"Kod"},"description":"Coin kodu (ör. BTC)"},{"name":"miktar","in":"query","required":true,"schema":{"type":"number","maximum":1000000000000000.0,"exclusiveMinimum":0,"description":"Tutar","title":"Miktar"},"description":"Tutar"},{"name":"birim","in":"query","required":false,"schema":{"type":"string","pattern":"^(coin|usd|tl)$","description":"miktar neyin: coin (varsayılan), usd ya da tl","default":"coin","title":"Birim"},"description":"miktar neyin: coin (varsayılan), usd ya da tl"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kripto/{kod}":{"get":{"tags":["kripto"],"summary":"Tek coin: USD ve TL fiyatı, alış/satış, gün içi aralık","operationId":"kripto_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kripto/{kod}/grafik":{"get":{"tags":["kripto"],"summary":"Kripto mum grafiği (USD ve TL): 15 dk, 1 saat, günlük geçmiş","operationId":"kripto_kod_grafik","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}},{"name":"aralik","in":"query","required":false,"schema":{"type":"string","pattern":"^(15m|1h|1d)$","description":"15m (son 24 saat), 1h (son 7 gün), 1d (günlük geçmiş; arşiv her gün uzar)","default":"1d","title":"Aralik"},"description":"15m (son 24 saat), 1h (son 7 gün), 1d (günlük geçmiş; arşiv her gün uzar)"},{"name":"adet","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":3650,"minimum":1},{"type":"null"}],"description":"Son kaç mum (varsayılan: 1d'de 365, diğerlerinde tümü)","title":"Adet"},"description":"Son kaç mum (varsayılan: 1d'de 365, diğerlerinde tümü)"},{"name":"para","in":"query","required":false,"schema":{"type":"string","pattern":"^(ikisi|usd|tl)$","description":"Mumlarda hangi para: ikisi, usd, tl","default":"ikisi","title":"Para"},"description":"Mumlarda hangi para: ikisi, usd, tl"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/istasyonlar":{"get":{"summary":"Şarj istasyonları (il / ilçe, operatör, soket, güç filtreli)","operationId":"sarj_istasyonlar","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (il ya da ilçe; boşsa Türkiye)","title":"Konum"},"description":"Konum slug'ı (il ya da ilçe; boşsa Türkiye)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"operator","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle operatör kodu ya da id (ör. zes,esarj,trugo; bkz. /v1/sarj/operatorler)","title":"Operator"},"description":"Virgülle operatör kodu ya da id (ör. zes,esarj,trugo; bkz. /v1/sarj/operatorler)"},{"name":"soket","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle soket tipi (ör. ccs2,type2; bkz. /v1/sarj/soket-tipleri)","title":"Soket"},"description":"Virgülle soket tipi (ör. ccs2,type2; bkz. /v1/sarj/soket-tipleri)"},{"name":"dc","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: yalnızca DC (hızlı) soketli, false: yalnızca AC","title":"Dc"},"description":"true: yalnızca DC (hızlı) soketli, false: yalnızca AC"},{"name":"min_kw","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000,"minimum":0},{"type":"null"}],"description":"En yüksek soket gücü en az (kW)","title":"Min Kw"},"description":"En yüksek soket gücü en az (kW)"},{"name":"herkese_acik","in":"query","required":false,"schema":{"type":"boolean","description":"Özel (müşteri / çalışan) istasyonları çıkar","default":false,"title":"Herkese Acik"},"description":"Özel (müşteri / çalışan) istasyonları çıkar"},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Sayfa"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/istasyonlar/{istasyon_id}":{"get":{"summary":"Tek istasyon","operationId":"sarj_istasyonlar_istasyon_id","parameters":[{"name":"istasyon_id","in":"path","required":true,"schema":{"type":"integer","title":"Istasyon Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/yakin":{"get":{"summary":"Koordinata en yakın şarj istasyonları (mesafeye göre)","operationId":"sarj_yakin","parameters":[{"name":"enlem","in":"query","required":true,"schema":{"type":"number","maximum":43,"minimum":35,"title":"Enlem"}},{"name":"boylam","in":"query","required":true,"schema":{"type":"number","maximum":45,"minimum":25,"title":"Boylam"}},{"name":"yaricap","in":"query","required":false,"schema":{"type":"number","maximum":100,"exclusiveMinimum":0,"description":"km","default":10,"title":"Yaricap"},"description":"km"},{"name":"operator","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle operatör kodu ya da id (ör. zes,esarj,trugo; bkz. /v1/sarj/operatorler)","title":"Operator"},"description":"Virgülle operatör kodu ya da id (ör. zes,esarj,trugo; bkz. /v1/sarj/operatorler)"},{"name":"soket","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle soket tipi (ör. ccs2,type2; bkz. /v1/sarj/soket-tipleri)","title":"Soket"},"description":"Virgülle soket tipi (ör. ccs2,type2; bkz. /v1/sarj/soket-tipleri)"},{"name":"dc","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: yalnızca DC (hızlı) soketli, false: yalnızca AC","title":"Dc"},"description":"true: yalnızca DC (hızlı) soketli, false: yalnızca AC"},{"name":"min_kw","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000,"minimum":0},{"type":"null"}],"description":"En yüksek soket gücü en az (kW)","title":"Min Kw"},"description":"En yüksek soket gücü en az (kW)"},{"name":"herkese_acik","in":"query","required":false,"schema":{"type":"boolean","description":"Özel (müşteri / çalışan) istasyonları çıkar","default":false,"title":"Herkese Acik"},"description":"Özel (müşteri / çalışan) istasyonları çıkar"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/yeni":{"get":{"summary":"Son eklenen şarj istasyonları (haberler için)","operationId":"sarj_yeni","parameters":[{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Gun"}},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Konum"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/operatorler":{"get":{"summary":"Şarj operatörleri ve istasyon / soket sayıları","operationId":"sarj_operatorler","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Konum"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/soket-tipleri":{"get":{"summary":"Soket tipi kodları","operationId":"sarj_soket_tipleri","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/sarj/istatistik":{"get":{"summary":"Türkiye / il / ilçe şarj altyapısı özeti","operationId":"sarj_istatistik","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Konum"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sarj/gecmis":{"get":{"summary":"Günlük istasyon / soket sayısı (toplamaya başladığımız günden)","operationId":"sarj_gecmis","parameters":[{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":3660,"minimum":1,"default":30,"title":"Gun"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/findik":{"get":{"summary":"Fındık fiyatları: kalite ortalamaları, merkezler (il / ilçe) ve değişimleri, TMO alım fiyatı","operationId":"findik","parameters":[{"name":"merkez","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle merkez kodları ya da adları (ör. akcakoca,ordu)","title":"Merkez"},"description":"Virgülle merkez kodları ya da adları (ör. akcakoca,ordu)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Yalnızca bu ildeki merkezler (ad, slug ya da plaka)","title":"Il"},"description":"Yalnızca bu ildeki merkezler (ad, slug ya da plaka)"},{"name":"kalite","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle kaliteler: sivri, levant, giresun","title":"Kalite"},"description":"Virgülle kaliteler: sivri, levant, giresun"},{"name":"istatistik","in":"query","required":false,"schema":{"type":"boolean","description":"Merkez başına haftalık / aylık / yıllık değişim dahil","default":true,"title":"Istatistik"},"description":"Merkez başına haftalık / aylık / yıllık değişim dahil"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/findik/tuccarlar":{"get":{"summary":"Tüccarların fındık alış fiyatları (firma, ilçe / il, kalite, ilan tarihi)","operationId":"findik_tuccarlar","parameters":[{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Firmanın bulunduğu il (ad, slug ya da plaka)","title":"Il"},"description":"Firmanın bulunduğu il (ad, slug ya da plaka)"},{"name":"merkez","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Bu merkezin sayfasında listelenen firmalar (ör. akcakoca)","title":"Merkez"},"description":"Bu merkezin sayfasında listelenen firmalar (ör. akcakoca)"},{"name":"kalite","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle kaliteler; yalnızca bu kalitelerde fiyatı olanlar","title":"Kalite"},"description":"Virgülle kaliteler; yalnızca bu kalitelerde fiyatı olanlar"},{"name":"gun","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"description":"Yalnızca son N gün içinde güncellenen fiyatlar","title":"Gun"},"description":"Yalnızca son N gün içinde güncellenen fiyatlar"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/findik/gecmis":{"get":{"summary":"Günlük fındık fiyatı geçmişi (kalite ortalamaları ve merkezler)","operationId":"findik_gecmis","parameters":[{"name":"merkez","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tek merkez kodu (ör. akcakoca); boşsa tümü","title":"Merkez"},"description":"Tek merkez kodu (ör. akcakoca); boşsa tümü"},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":366,"minimum":1,"default":30,"title":"Gun"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/burc/burclar":{"get":{"summary":"12 burç: tarih aralığı, element, nitelik, yönetici gezegen","operationId":"burc_burclar","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/burc/bul":{"get":{"summary":"Doğum tarihinden güneş burcu","operationId":"burc_bul","parameters":[{"name":"tarih","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Doğum tarihi (YYYY-AA-GG)","title":"Tarih"},"description":"Doğum tarihi (YYYY-AA-GG)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/burc/gunluk":{"get":{"summary":"Günlük burç yorumu (genel; pakete göre aşk, kariyer, sağlık), açılar ve gezegen geçişleri","operationId":"burc_gunluk","parameters":[{"name":"burc","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Burç kodu ya da adı (koc, boga…); boşsa 12 burç","title":"Burc"},"description":"Burç kodu ya da adı (koc, boga…); boşsa 12 burç"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle yorum türleri: genel, ask, kariyer, saglik","title":"Tur"},"description":"Virgülle yorum türleri: genel, ask, kariyer, saglik"},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Gün (YYYY-AA-GG); varsayılan bugün, son 7 gün tutulur","title":"Tarih"},"description":"Gün (YYYY-AA-GG); varsayılan bugün, son 7 gün tutulur"},{"name":"dil","in":"query","required":false,"schema":{"type":"string","pattern":"^(tr|en)$","description":"tr: Türkçe çeviri, en: kaynaktaki özgün metin","default":"tr","title":"Dil"},"description":"tr: Türkçe çeviri, en: kaynaktaki özgün metin"},{"name":"ayrinti","in":"query","required":false,"schema":{"type":"boolean","description":"Açılar ve gezegen geçişleri dahil","default":true,"title":"Ayrinti"},"description":"Açılar ve gezegen geçişleri dahil"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rehber/kategoriler":{"get":{"summary":"Şehir rehberi türleri (gezilecek yerler ve tesisler)","operationId":"rehber_kategoriler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/rehber/gezilecek":{"get":{"summary":"Gezilecek yerler: müze, kale, ören yeri, mağara, şelale, plaj, seyir noktası…","operationId":"rehber_gezilecek","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe ya da il slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"İlçe ya da il slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":43,"minimum":35},{"type":"null"}],"title":"Enlem"}},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":45,"minimum":25},{"type":"null"}],"title":"Boylam"}},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle türler (/v1/rehber/kategoriler)","title":"Tur"},"description":"Virgülle türler (/v1/rehber/kategoriler)"},{"name":"yaricap","in":"query","required":false,"schema":{"type":"number","maximum":50,"exclusiveMinimum":0,"description":"Koordinatla aramada km","default":10,"title":"Yaricap"},"description":"Koordinatla aramada km"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rehber/tesisler":{"get":{"summary":"Tesisler: hastane, üniversite, kütüphane, AVM, havalimanı, tren istasyonu, iskele","operationId":"rehber_tesisler","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Konum"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":43,"minimum":35},{"type":"null"}],"title":"Enlem"}},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":45,"minimum":25},{"type":"null"}],"title":"Boylam"}},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle türler (/v1/rehber/kategoriler)","title":"Tur"},"description":"Virgülle türler (/v1/rehber/kategoriler)"},{"name":"yaricap","in":"query","required":false,"schema":{"type":"number","maximum":50,"exclusiveMinimum":0,"default":10,"title":"Yaricap"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rehber/yeme-icme":{"get":{"summary":"Yeme-içme: restoran / lokanta, pide-döner, kafe, dondurma (mutfak türüyle)","operationId":"rehber_yeme_icme","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Konum"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":43,"minimum":35},{"type":"null"}],"title":"Enlem"}},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":45,"minimum":25},{"type":"null"}],"title":"Boylam"}},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle türler (/v1/rehber/kategoriler)","title":"Tur"},"description":"Virgülle türler (/v1/rehber/kategoriler)"},{"name":"mutfak","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Mutfak adı, ör. Balık (/v1/rehber/kategoriler → mutfaklar)","title":"Mutfak"},"description":"Mutfak adı, ör. Balık (/v1/rehber/kategoriler → mutfaklar)"},{"name":"yaricap","in":"query","required":false,"schema":{"type":"number","maximum":50,"exclusiveMinimum":0,"default":5,"title":"Yaricap"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/sinir/bul":{"get":{"summary":"Koordinat hangi il ve ilçede? (ilçe sınır poligonuyla)","operationId":"konumlar_sinir_bul","parameters":[{"name":"enlem","in":"query","required":true,"schema":{"type":"number","maximum":43,"minimum":35,"title":"Enlem"}},{"name":"boylam","in":"query","required":true,"schema":{"type":"number","maximum":45,"minimum":25,"title":"Boylam"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/sinir":{"get":{"summary":"İl ya da ilçe sınırı (GeoJSON; il → ilçeleriyle FeatureCollection)","operationId":"konumlar_sinir","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Konum"}},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spor/ligler":{"get":{"summary":"Desteklenen ligler ve hangi verinin olduğu","operationId":"spor_ligler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/spor/puan-durumu":{"get":{"summary":"Puan durumu: Süper Lig, 1. Lig, 2. Lig (Beyaz / Kırmızı), 3. Lig (1–3. grup)","operationId":"spor_puan_durumu","parameters":[{"name":"lig","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle lig kodları (super-lig, 1-lig, 2-lig-beyaz, 2-lig-kirmizi, 3-lig-1…; 2-lig / 3-lig tüm grupları); boşsa hepsi","title":"Lig"},"description":"Virgülle lig kodları (super-lig, 1-lig, 2-lig-beyaz, 2-lig-kirmizi, 3-lig-1…; 2-lig / 3-lig tüm grupları); boşsa hepsi"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spor/maclar":{"get":{"summary":"Maç sonuçları ve fikstür (lig, tarih, takım, durum)","operationId":"spor_maclar","parameters":[{"name":"lig","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle lig kodları (super-lig, 1-lig, 2-lig, 3-lig-1…)","title":"Lig"},"description":"Virgülle lig kodları (super-lig, 1-lig, 2-lig, 3-lig-1…)"},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Gün (YYYY-AA-GG)","title":"Tarih"},"description":"Gün (YYYY-AA-GG)"},{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"takim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Takım adının bir kısmı (ör. düzcespor)","title":"Takim"},"description":"Takım adının bir kısmı (ör. düzcespor)"},{"name":"durum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(bitti|canli|oynanacak|ertelendi)$"},{"type":"null"}],"title":"Durum"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oyun/firsatlar":{"get":{"tags":["oyun"],"summary":"İndirimdeki PC oyunları (Steam, GOG, Epic, Humble… mağaza karşılaştırmalı)","operationId":"oyun_firsatlar","parameters":[{"name":"magaza","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle mağaza id ya da adı (ör. steam,gog)","title":"Magaza"},"description":"Virgülle mağaza id ya da adı (ör. steam,gog)"},{"name":"min_indirim","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":0,"description":"En az indirim (%)","default":0,"title":"Min Indirim"},"description":"En az indirim (%)"},{"name":"max_fiyat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"En çok fiyat (USD)","title":"Max Fiyat"},"description":"En çok fiyat (USD)"},{"name":"min_metacritic","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":0,"default":0,"title":"Min Metacritic"}},{"name":"sirala","in":"query","required":false,"schema":{"type":"string","pattern":"^(puan|indirim|fiyat|metacritic|yeni)$","default":"puan","title":"Sirala"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Sayfa"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oyun/ucretsiz":{"get":{"tags":["oyun"],"summary":"Şu an ücretsiz olan PC oyunları","operationId":"oyun_ucretsiz","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oyun/magazalar":{"get":{"tags":["oyun"],"summary":"Takip edilen dijital oyun mağazaları","operationId":"oyun_magazalar","parameters":[{"name":"tumu","in":"query","required":false,"schema":{"type":"boolean","description":"Kapalı mağazalar da","default":false,"title":"Tumu"},"description":"Kapalı mağazalar da"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oyun/ara":{"get":{"tags":["oyun"],"summary":"Oyun ara (en ucuz güncel fiyatla)","operationId":"oyun_ara","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":60,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oyun/{oyun_id}":{"get":{"tags":["oyun"],"summary":"Oyunun tüm mağazalardaki fiyatları ve tarihteki en düşük fiyatı","operationId":"oyun_oyun_id","parameters":[{"name":"oyun_id","in":"path","required":true,"schema":{"type":"integer","title":"Oyun Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/besin/kategoriler":{"get":{"tags":["besin"],"summary":"Besin kategorileri ve kayıt sayıları","operationId":"besin_kategoriler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/besin/ara":{"get":{"tags":["besin"],"summary":"Gıda / yemek ara (Türkçe; ör. elma, mercimek, köfte)","operationId":"besin_ara","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Q"}},{"name":"kategori","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kategori kodu (bkz. /v1/besin/kategoriler)","title":"Kategori"},"description":"Kategori kodu (bkz. /v1/besin/kategoriler)"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(gida|yemek)$"},{"type":"null"}],"title":"Tur"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/besin/hesapla":{"get":{"tags":["besin"],"summary":"Öğün / liste toplamı (ör. liste=mercimek-corbasi,pirinc-pilavi:2x,ayran:200)","operationId":"besin_hesapla","parameters":[{"name":"liste","in":"query","required":true,"schema":{"type":"string","maxLength":2000,"description":"Virgülle `slug`, `slug:gram` ya da `slug:2x` (porsiyon katı)","title":"Liste"},"description":"Virgülle `slug`, `slug:gram` ya da `slug:2x` (porsiyon katı)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/besin/{slug}":{"get":{"tags":["besin"],"summary":"Gıda / yemeğin besin değerleri (100 g, porsiyon ya da istenen miktar)","operationId":"besin_slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"gram","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":5000,"exclusiveMinimum":0},{"type":"null"}],"title":"Gram"}},{"name":"porsiyon","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"Porsiyon adı ya da sırası (1, 2…)","title":"Porsiyon"},"description":"Porsiyon adı ya da sırası (1, 2…)"},{"name":"adet","in":"query","required":false,"schema":{"type":"number","maximum":100,"exclusiveMinimum":0,"description":"Porsiyon sayısı","default":1,"title":"Adet"},"description":"Porsiyon sayısı"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hava-kalitesi":{"get":{"summary":"Hava kalitesi: PM2.5, PM10, NO₂, O₃, SO₂, CO, toz; Avrupa ve ABD indeksi","operationId":"hava_kalitesi","parameters":[{"name":"saat","in":"query","required":false,"schema":{"type":"integer","maximum":72,"minimum":0,"description":"Saatlik tahmin (saat)","default":24,"title":"Saat"},"description":"Saatlik tahmin (saat)"},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hava/detay":{"get":{"summary":"Ayrıntılı hava: hissedilen, çiy noktası, basınç, görüş, hamle; 16 güne kadar tahmin","operationId":"hava_detay","parameters":[{"name":"saat","in":"query","required":false,"schema":{"type":"integer","maximum":384,"minimum":0,"default":48,"title":"Saat"}},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":16,"minimum":1,"default":7,"title":"Gun"}},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hava/yagis":{"get":{"summary":"Yağış tahmini: 15 dakikalık (24 saat) ve saatlik (48 saat), olasılık, kar","operationId":"hava_yagis","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trafik":{"get":{"summary":"Trafik akışı: noktadaki yolun anlık hızı, serbest akış hızı, yoğunluk yüzdesi","operationId":"trafik","parameters":[{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trafik/olaylar":{"get":{"summary":"Trafik olayları: kaza, yol çalışması, kapalı yol (konumun çevresinde)","operationId":"trafik_olaylar","parameters":[{"name":"yaricap","in":"query","required":false,"schema":{"type":"number","maximum":50,"minimum":1,"description":"km","default":10,"title":"Yaricap"},"description":"km"},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Konum slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"Konum slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)","title":"Il"},"description":"İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (il ile birlikte)","title":"Ilce"},"description":"İlçe adı (il ile birlikte)"},{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Enlem (en yakın konum)","title":"Enlem"},"description":"Enlem (en yakın konum)"},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Boylam","title":"Boylam"},"description":"Boylam"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/eczane/nobetci":{"get":{"summary":"Nöbetçi eczaneler (il, isteğe bağlı ilçe)","operationId":"eczane_nobetci","parameters":[{"name":"il","in":"query","required":true,"schema":{"type":"string","description":"İl adı, slug'ı ya da plaka","title":"Il"},"description":"İl adı, slug'ı ya da plaka"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/ay":{"get":{"summary":"Günün ay evresi, aydınlanma yüzdesi, ay yaşı ve sıradaki evreler","operationId":"takvim_ay","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"YYYY-AA-GG, varsayılan bugün","title":"Tarih"},"description":"YYYY-AA-GG, varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/ay-evreleri":{"get":{"summary":"Ay veya yıl içindeki yeni ay, ilk dördün, dolunay, son dördün anları","operationId":"takvim_ay_evreleri","parameters":[{"name":"yil","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1900,"title":"Yil"}},{"name":"ay","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":12,"minimum":1},{"type":"null"}],"title":"Ay"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/okul":{"get":{"summary":"MEB çalışma takvimi: ders başı/sonu, ara tatiller, yarıyıl tatili","operationId":"takvim_okul","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{4}$"},{"type":"null"}],"description":"Eğitim yılı (ör. 2026-2027)","title":"Yil"},"description":"Eğitim yılı (ör. 2026-2027)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/okul/gun":{"get":{"summary":"Tarihte okul var mı? Sıradaki tatile kalan gün","operationId":"takvim_okul_gun","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Tarih"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/iban/dogrula":{"get":{"summary":"IBAN doğrulama (MOD-97) ve Türkiye IBAN'ında banka adı","operationId":"iban_dogrula","parameters":[{"name":"iban","in":"query","required":true,"schema":{"type":"string","minLength":5,"maxLength":42,"title":"Iban"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bankalar":{"get":{"summary":"Türkiye'deki bankalar ve 5 haneli banka (EFT) kodları","operationId":"bankalar","parameters":[{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"mevduat, katilim, kalkinma","title":"Tur"},"description":"mevduat, katilim, kalkinma"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bankalar/{kod}":{"get":{"summary":"Banka kodu → banka","operationId":"bankalar_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/posta-kodu":{"get":{"summary":"Posta kodu → il, ilçe ve mahalleler","operationId":"posta_kodu","parameters":[{"name":"kod","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{5}$","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/posta-kodu/ara":{"get":{"summary":"İl / ilçe (/ mahalle) → posta kodları","operationId":"posta_kodu_ara","parameters":[{"name":"il","in":"query","required":true,"schema":{"type":"string","title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"mahalle","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mahalle"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kargo/firmalar":{"get":{"summary":"Kargo firmaları ve resmî takip sayfaları","operationId":"kargo_firmalar","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/kargo/takip":{"get":{"summary":"Takip numarasından olası firma(lar) ve takip bağlantısı","operationId":"kargo_takip","parameters":[{"name":"no","in":"query","required":true,"schema":{"type":"string","minLength":6,"maxLength":40,"title":"No"}},{"name":"firma","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Firma kodu (liste: /v1/kargo/firmalar)","title":"Firma"},"description":"Firma kodu (liste: /v1/kargo/firmalar)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/ufe":{"get":{"summary":"Yİ-ÜFE: endeks, aylık, yıllık ve 12 aylık ortalama değişim","operationId":"ekonomi_ufe","parameters":[{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":24,"title":"Ay"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/tufe-ufe":{"get":{"summary":"TÜFE ve Yİ-ÜFE yan yana (son ay ve aylık seri)","operationId":"ekonomi_tufe_ufe","parameters":[{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":12,"title":"Ay"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/mevduat-faizi":{"get":{"summary":"Bankaların TL mevduata uyguladığı ağırlıklı ortalama faiz (vadeye göre, haftalık)","operationId":"ekonomi_mevduat_faizi","parameters":[{"name":"hafta","in":"query","required":false,"schema":{"type":"integer","maximum":104,"minimum":1,"default":12,"title":"Hafta"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/doviz/gecmis":{"get":{"summary":"TCMB döviz alış / satış kuru geçmişi (günlük, 5 yıla kadar)","operationId":"doviz_gecmis","parameters":[{"name":"kod","in":"query","required":false,"schema":{"type":"string","minLength":3,"maxLength":3,"default":"USD","title":"Kod"}},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":1830,"minimum":1,"default":30,"title":"Gun"}},{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/gostergeler":{"get":{"summary":"Ekonomik göstergeler: son değerler (işsizlik, rezerv, dış ticaret, kira endeksi, beklentiler…)","operationId":"ekonomi_gostergeler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/ekonomi/gostergeler/{kod}":{"get":{"summary":"Tek göstergenin geçmişi (aylık ya da haftalık)","operationId":"ekonomi_gostergeler_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"Kaç dönem geriye (yeniden eskiye)","default":24,"title":"Adet"},"description":"Kaç dönem geriye (yeniden eskiye)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/tufe-kalemler":{"get":{"summary":"TÜFE ana harcama grupları ve alt kalemleri: son ay endeks, aylık ve yıllık değişim","operationId":"ekonomi_tufe_kalemler","parameters":[{"name":"ust","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Üst kalem kodu (ör. 01 gıda); verilirse yalnızca alt kalemleri","title":"Ust"},"description":"Üst kalem kodu (ör. 01 gıda); verilirse yalnızca alt kalemleri"},{"name":"seviye","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":4,"minimum":0},{"type":"null"}],"description":"0 genel, 1 ana grup … 4 en alt","title":"Seviye"},"description":"0 genel, 1 ana grup … 4 en alt"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/tufe-kalemler/{kod}":{"get":{"summary":"Bir TÜFE kaleminin aylık endeksi, aylık ve yıllık değişimi","operationId":"ekonomi_tufe_kalemler_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}},{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":72,"minimum":1,"default":24,"title":"Ay"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/konut-fiyat-endeksi":{"get":{"summary":"Konut fiyat endeksi: Türkiye, İstanbul, Ankara, İzmir (aylık, yıllık değişim)","operationId":"ekonomi_konut_fiyat_endeksi","parameters":[{"name":"bolge","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"turkiye | istanbul | ankara | izmir","title":"Bolge"},"description":"turkiye | istanbul | ankara | izmir"},{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"default":24,"title":"Ay"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/turizm":{"get":{"summary":"Yabancı ziyaretçi sayısı (aylık, ülkelere göre) ve turizm geliri","operationId":"ekonomi_turizm","parameters":[{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"default":12,"title":"Ay"}},{"name":"ulke","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO ülke kodu (ör. DE)","title":"Ulke"},"description":"ISO ülke kodu (ör. DE)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Son ayda en çok gelen kaç ülke","default":20,"title":"Limit"},"description":"Son ayda en çok gelen kaç ülke"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ekonomi/ucretler-dunya":{"get":{"summary":"Ülkelerin asgari ve ortalama ücretleri (euro karşılığıyla)","operationId":"ekonomi_ucretler_dunya","parameters":[{"name":"olcu","in":"query","required":false,"schema":{"type":"string","pattern":"^(asgari|ortalama)$","default":"asgari","title":"Olcu"}},{"name":"ulke","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ulke"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulasim/mesafe":{"get":{"summary":"İller arası karayolu mesafesi (KGM, il merkezleri arası km)","operationId":"ulasim_mesafe","parameters":[{"name":"nereden","in":"query","required":true,"schema":{"type":"string","description":"İl adı, slug ya da plaka","title":"Nereden"},"description":"İl adı, slug ya da plaka"},{"name":"nereye","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Boşsa nereden ilinden tüm illere (yakından uzağa)","title":"Nereye"},"description":"Boşsa nereden ilinden tüm illere (yakından uzağa)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rehber/muzeler":{"get":{"summary":"Bakanlığa bağlı müze ve ören yerleri: giriş ücreti, konum, kapalı günler","operationId":"rehber_muzeler","parameters":[{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı, slug ya da plaka","title":"Il"},"description":"İl adı, slug ya da plaka"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2},{"type":"null"}],"description":"Adda ara","title":"Q"},"description":"Adda ara"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":400,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rehber/muzekart":{"get":{"summary":"Müzekart türleri ve ücretleri","operationId":"rehber_muzekart","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/hesapla/maas-doviz":{"get":{"tags":["hesapla"],"summary":"Maaşı dövize çevir (aylık / yıllık / günlük / saatlik; anlık ya da TCMB kuru)","operationId":"hesapla_maas_doviz","parameters":[{"name":"maas","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"Maaş tutarı","title":"Maas"},"description":"Maaş tutarı"},{"name":"para","in":"query","required":false,"schema":{"type":"string","minLength":3,"maxLength":3,"description":"Maaşın para birimi","default":"TRY","title":"Para"},"description":"Maaşın para birimi"},{"name":"hedef","in":"query","required":false,"schema":{"type":"string","description":"Virgülle hedef paralar","default":"USD,EUR,GBP","title":"Hedef"},"description":"Virgülle hedef paralar"},{"name":"donem","in":"query","required":false,"schema":{"type":"string","pattern":"^(aylik|yillik|haftalik|gunluk|saatlik)$","description":"Verilen tutarın dönemi","default":"aylik","title":"Donem"},"description":"Verilen tutarın dönemi"},{"name":"kur","in":"query","required":false,"schema":{"type":"string","pattern":"^(anlik|referans|tcmb)$","description":"anlik: Kapalıçarşı satış; referans: ECB; tcmb: TCMB döviz satış","default":"anlik","title":"Kur"},"description":"anlik: Kapalıçarşı satış; referans: ECB; tcmb: TCMB döviz satış"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/maas-gecmis":{"get":{"tags":["hesapla"],"summary":"Geçmişteki maaş: o gün kaç dolardı, bugün aynı döviz / alım gücü için kaç TL gerekir","operationId":"hesapla_maas_gecmis","parameters":[{"name":"maas","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"Maaş tutarı","title":"Maas"},"description":"Maaş tutarı"},{"name":"tarih","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Maaşın alındığı tarih (YYYY-AA-GG)","title":"Tarih"},"description":"Maaşın alındığı tarih (YYYY-AA-GG)"},{"name":"para","in":"query","required":false,"schema":{"type":"string","minLength":3,"maxLength":3,"default":"TRY","title":"Para"}},{"name":"hedef","in":"query","required":false,"schema":{"type":"string","minLength":3,"maxLength":3,"default":"USD","title":"Hedef"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/maas-enflasyon":{"get":{"tags":["hesapla"],"summary":"Maaşı enflasyona (TÜFE) göre güncelle; isteğe bağlı bugünkü maaşla reel değişim","operationId":"hesapla_maas_enflasyon","parameters":[{"name":"maas","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"Maaş tutarı","title":"Maas"},"description":"Maaş tutarı"},{"name":"baslangic","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$","description":"YYYY-AA","title":"Baslangic"},"description":"YYYY-AA"},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}],"description":"YYYY-AA (varsayılan son açıklanan ay)","title":"Bitis"},"description":"YYYY-AA (varsayılan son açıklanan ay)"},{"name":"guncel_maas","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"Bugünkü maaş (reel değişim için)","title":"Guncel Maas"},"description":"Bugünkü maaş (reel değişim için)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/maas-zam":{"get":{"tags":["hesapla"],"summary":"Zamlı maaş, zam oranı ve enflasyona göre reel zam","operationId":"hesapla_maas_zam","parameters":[{"name":"maas","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"Maaş tutarı","title":"Maas"},"description":"Maaş tutarı"},{"name":"zam_orani","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000,"minimum":-100},{"type":"null"}],"description":"Zam (%)","title":"Zam Orani"},"description":"Zam (%)"},{"name":"yeni_maas","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"ya da yeni maaş","title":"Yeni Maas"},"description":"ya da yeni maaş"},{"name":"enflasyon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000,"minimum":-100},{"type":"null"}],"description":"Karşılaştırılacak enflasyon (%); boşsa son yıllık TÜFE","title":"Enflasyon"},"description":"Karşılaştırılacak enflasyon (%); boşsa son yıllık TÜFE"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/maas-karsilastir":{"get":{"tags":["hesapla"],"summary":"İki tarihteki maaşı karşılaştır: nominal, reel (TÜFE), döviz ve asgari ücret katı","operationId":"hesapla_maas_karsilastir","parameters":[{"name":"maas1","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"İlk maaş","title":"Maas1"},"description":"İlk maaş"},{"name":"tarih1","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Tarih1"}},{"name":"maas2","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"Sonraki maaş","title":"Maas2"},"description":"Sonraki maaş"},{"name":"tarih2","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Varsayılan bugün","title":"Tarih2"},"description":"Varsayılan bugün"},{"name":"doviz","in":"query","required":false,"schema":{"type":"string","description":"Virgülle; boş = döviz karşılaştırması yok","default":"USD,EUR","title":"Doviz"},"description":"Virgülle; boş = döviz karşılaştırması yok"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/maas-donem":{"get":{"tags":["hesapla"],"summary":"Maaşı dönemler arasında çevir (aylık ↔ yıllık ↔ günlük ↔ saatlik)","operationId":"hesapla_maas_donem","parameters":[{"name":"maas","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"description":"Maaş tutarı","title":"Maas"},"description":"Maaş tutarı"},{"name":"donem","in":"query","required":false,"schema":{"type":"string","pattern":"^(aylik|yillik|haftalik|gunluk|saatlik)$","description":"Verilen tutarın dönemi","default":"aylik","title":"Donem"},"description":"Verilen tutarın dönemi"},{"name":"saat","in":"query","required":false,"schema":{"type":"number","maximum":744,"exclusiveMinimum":0,"description":"Aylık çalışma saati","default":225,"title":"Saat"},"description":"Aylık çalışma saati"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/kredi":{"get":{"tags":["hesapla"],"summary":"Kredi ödeme planı: aylık taksit, toplam faiz, KKDF, BSMV, yıllık maliyet","operationId":"hesapla_kredi","parameters":[{"name":"tutar","in":"query","required":true,"schema":{"type":"number","maximum":10000000000.0,"exclusiveMinimum":0,"title":"Tutar"}},{"name":"vade","in":"query","required":true,"schema":{"type":"integer","maximum":360,"minimum":1,"description":"Ay","title":"Vade"},"description":"Ay"},{"name":"faiz","in":"query","required":true,"schema":{"type":"number","maximum":20,"minimum":0,"description":"Aylık akdi faiz (%), vergiler hariç","title":"Faiz"},"description":"Aylık akdi faiz (%), vergiler hariç"},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(ihtiyac|tasit|konut|ticari|kredi_karti)$","default":"ihtiyac","title":"Tur"}},{"name":"kkdf","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":50,"minimum":0},{"type":"null"}],"title":"Kkdf"}},{"name":"bsmv","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":50,"minimum":0},{"type":"null"}],"title":"Bsmv"}},{"name":"plan","in":"query","required":false,"schema":{"type":"boolean","description":"Ödeme planı tablosu dahil","default":true,"title":"Plan"},"description":"Ödeme planı tablosu dahil"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/kredi/oranlar":{"get":{"tags":["hesapla"],"summary":"Kredi türlerine göre KKDF ve BSMV oranları","operationId":"hesapla_kredi_oranlar","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/hesapla/mevduat":{"get":{"tags":["hesapla"],"summary":"Vadeli mevduat getirisi: brüt faiz, stopaj, net getiri","operationId":"hesapla_mevduat","parameters":[{"name":"tutar","in":"query","required":true,"schema":{"type":"number","maximum":100000000000.0,"exclusiveMinimum":0,"title":"Tutar"}},{"name":"faiz","in":"query","required":true,"schema":{"type":"number","maximum":200,"minimum":0,"description":"Yıllık brüt faiz (%)","title":"Faiz"},"description":"Yıllık brüt faiz (%)"},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":3650,"minimum":1,"description":"Vade (gün)","default":32,"title":"Gun"},"description":"Vade (gün)"},{"name":"para","in":"query","required":false,"schema":{"type":"string","pattern":"^(tl|doviz)$","default":"tl","title":"Para"}},{"name":"stopaj","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":50,"minimum":0},{"type":"null"}],"title":"Stopaj"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/yakit":{"get":{"tags":["hesapla"],"summary":"Yolculuk yakıt maliyeti (fiyat verilmezse ilin güncel EPDK ortalaması)","operationId":"hesapla_yakit","parameters":[{"name":"mesafe","in":"query","required":true,"schema":{"type":"number","maximum":50000,"exclusiveMinimum":0,"description":"km","title":"Mesafe"},"description":"km"},{"name":"tuketim","in":"query","required":true,"schema":{"type":"number","maximum":100,"exclusiveMinimum":0,"description":"L/100 km (LPG için L, elektrik için kWh)","title":"Tuketim"},"description":"L/100 km (LPG için L, elektrik için kWh)"},{"name":"fiyat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000,"exclusiveMinimum":0},{"type":"null"}],"description":"Birim fiyat (TL)","title":"Fiyat"},"description":"Birim fiyat (TL)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Fiyat için il (ad, slug, plaka)","title":"Il"},"description":"Fiyat için il (ad, slug, plaka)"},{"name":"yakit","in":"query","required":false,"schema":{"type":"string","pattern":"^(benzin|motorin|otogaz)$","default":"benzin","title":"Yakit"}},{"name":"kisi","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":1,"title":"Kisi"}},{"name":"gidis_donus","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Gidis Donus"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/mtv":{"get":{"tags":["hesapla"],"summary":"Motorlu Taşıtlar Vergisi (otomobil, arazi taşıtı, motosiklet; yıllık ve taksit)","operationId":"hesapla_mtv","parameters":[{"name":"silindir","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":50},{"type":"null"}],"description":"Motor silindir hacmi (cm³)","title":"Silindir"},"description":"Motor silindir hacmi (cm³)"},{"name":"yas","in":"query","required":true,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Taşıt yaşı (model yılı dahil, ör. 2026 model = 1)","title":"Yas"},"description":"Taşıt yaşı (model yılı dahil, ör. 2026 model = 1)"},{"name":"deger","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0},{"type":"null"}],"description":"Taşıt değeri (KDV hariç; 2018 sonrası tescil)","title":"Deger"},"description":"Taşıt değeri (KDV hariç; 2018 sonrası tescil)"},{"name":"tescil","in":"query","required":false,"schema":{"type":"string","pattern":"^(2018_oncesi|2018_sonrasi)$","default":"2018_sonrasi","title":"Tescil"}},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(otomobil|motosiklet|elektrikli|panelvan)$","default":"otomobil","title":"Tur"}},{"name":"guc","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":2000,"minimum":1},{"type":"null"}],"description":"Elektrik motor gücü (kW)","title":"Guc"},"description":"Elektrik motor gücü (kW)"},{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2026},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/mtv/tarife":{"get":{"tags":["hesapla"],"summary":"MTV tarifesi (I sayılı tarife, yıl)","operationId":"hesapla_mtv_tarife","parameters":[{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2026},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/kidem":{"get":{"tags":["hesapla"],"summary":"Kıdem tazminatı (tavan, damga vergisi, net)","operationId":"hesapla_kidem","parameters":[{"name":"brut","in":"query","required":true,"schema":{"type":"number","maximum":100000000.0,"exclusiveMinimum":0,"description":"Son aylık brüt ücret","title":"Brut"},"description":"Son aylık brüt ücret"},{"name":"giris","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Giris"}},{"name":"cikis","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Cikis"}},{"name":"ek_odeme","in":"query","required":false,"schema":{"type":"number","maximum":100000000.0,"minimum":0,"description":"Aylık düzenli ek ödemeler (yol, yemek, ikramiye/12…)","default":0,"title":"Ek Odeme"},"description":"Aylık düzenli ek ödemeler (yol, yemek, ikramiye/12…)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/kidem/tavan":{"get":{"tags":["hesapla"],"summary":"Kıdem tazminatı tavanları (dönemler)","operationId":"hesapla_kidem_tavan","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/hesapla/ihbar":{"get":{"tags":["hesapla"],"summary":"İhbar tazminatı (süre, gelir vergisi, damga, net)","operationId":"hesapla_ihbar","parameters":[{"name":"brut","in":"query","required":true,"schema":{"type":"number","maximum":100000000.0,"exclusiveMinimum":0,"title":"Brut"}},{"name":"giris","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Giris"}},{"name":"cikis","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Cikis"}},{"name":"ek_odeme","in":"query","required":false,"schema":{"type":"number","maximum":100000000.0,"minimum":0,"default":0,"title":"Ek Odeme"}},{"name":"kumulatif_matrah","in":"query","required":false,"schema":{"type":"number","maximum":10000000000.0,"minimum":0,"description":"Yıl içinde oluşmuş gelir vergisi matrahı","default":0,"title":"Kumulatif Matrah"},"description":"Yıl içinde oluşmuş gelir vergisi matrahı"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/issizlik":{"get":{"tags":["hesapla"],"summary":"İşsizlik ödeneği: aylık tutar, süre, toplam","operationId":"hesapla_issizlik","parameters":[{"name":"brut_ortalama","in":"query","required":true,"schema":{"type":"number","maximum":100000000.0,"exclusiveMinimum":0,"description":"Son 4 ayın brüt kazanç ortalaması","title":"Brut Ortalama"},"description":"Son 4 ayın brüt kazanç ortalaması"},{"name":"prim_gunu","in":"query","required":true,"schema":{"type":"integer","maximum":1095,"minimum":0,"description":"Son 3 yıldaki prim günü","title":"Prim Gunu"},"description":"Son 3 yıldaki prim günü"},{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2026},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/emekli":{"get":{"tags":["hesapla"],"summary":"Emekli aylığı zammı (SSK/Bağ-Kur ve memur emeklisi; en düşük aylık dahil)","operationId":"hesapla_emekli","parameters":[{"name":"aylik","in":"query","required":true,"schema":{"type":"number","maximum":10000000.0,"exclusiveMinimum":0,"title":"Aylik"}},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(ssk_bagkur|memur)$","default":"ssk_bagkur","title":"Tur"}},{"name":"donem","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-(01|07)$"},{"type":"null"}],"description":"YYYY-01 | YYYY-07","title":"Donem"},"description":"YYYY-01 | YYYY-07"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/araclar/qr/turler":{"get":{"summary":"QR içerik türleri, alanları, biçimler ve seçenekler","operationId":"araclar_qr_turler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/araclar/qr":{"post":{"summary":"QR kod oluştur (Wi-Fi, vCard, URL, IBAN, WhatsApp… JSON gövde)","operationId":"araclar_qr_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QRIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Metin / adresten QR kod (doğrudan görsel; <img> için)","operationId":"araclar_qr","parameters":[{"name":"icerik","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2000,"description":"QR'a yazılacak metin / adres","title":"Icerik"},"description":"QR'a yazılacak metin / adres"},{"name":"bicim","in":"query","required":false,"schema":{"type":"string","description":"png, svg, webp, jpg","default":"png","title":"Bicim"},"description":"png, svg, webp, jpg"},{"name":"boyut","in":"query","required":false,"schema":{"type":"integer","maximum":2048,"minimum":64,"default":512,"title":"Boyut"}},{"name":"hata_duzeltme","in":"query","required":false,"schema":{"type":"string","default":"M","title":"Hata Duzeltme"}},{"name":"renk","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renk"}},{"name":"zemin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zemin"}},{"name":"kenar","in":"query","required":false,"schema":{"type":"integer","maximum":16,"minimum":0,"default":4,"title":"Kenar"}},{"name":"cikti","in":"query","required":false,"schema":{"type":"string","description":"dosya (varsayılan) ya da json","default":"dosya","title":"Cikti"},"description":"dosya (varsayılan) ya da json"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/araclar/qr/toplu":{"post":{"summary":"Toplu QR üretimi (en çok 100; ZIP ya da JSON)","operationId":"araclar_qr_toplu_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QRBatch"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/araclar/qr/oku":{"post":{"summary":"Görselden QR kod / barkod oku","description":"Görseldeki tüm QR kodları ve barkodları okur (EAN/UPC, Code 128/39/93, ITF, Codabar, DataBar, QR, Data Matrix, PDF417, Aztec). Gövde: multipart `dosya`, JSON `{\"gorsel\": base64}` ya da image/*. QR içeriği türüne göre çözümlenir (Wi-Fi, vCard, URL, SMS…), ürün barkodu doğrulanır. Gövde en çok 5 MB; PNG/WebP en çok 16 MP, JPEG en çok 50 MP. Görsel diske yazılmaz, yanıt verildikten sonra bellekten silinir.","operationId":"araclar_qr_oku_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/barkod/oku":{"post":{"summary":"Görselden barkod / QR oku","description":"Görseldeki tüm QR kodları ve barkodları okur (EAN/UPC, Code 128/39/93, ITF, Codabar, DataBar, QR, Data Matrix, PDF417, Aztec). Gövde: multipart `dosya`, JSON `{\"gorsel\": base64}` ya da image/*. QR içeriği türüne göre çözümlenir (Wi-Fi, vCard, URL, SMS…), ürün barkodu doğrulanır. Gövde en çok 5 MB; PNG/WebP en çok 16 MP, JPEG en çok 50 MP. Görsel diske yazılmaz, yanıt verildikten sonra bellekten silinir.","operationId":"barkod_oku_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/barkod/dogrula":{"get":{"summary":"Barkod doğrula: tür (EAN-13/8, UPC-A/E, GTIN-14, ISBN, ISSN), kontrol hanesi, GS1 öneki","operationId":"barkod_dogrula","parameters":[{"name":"kod","in":"query","required":true,"schema":{"type":"string","minLength":7,"maxLength":20,"description":"Barkod numarası","title":"Kod"},"description":"Barkod numarası"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/barkod/kontrol-hanesi":{"get":{"summary":"Kontrol hanesini hesapla (7 → EAN-8, 11 → UPC-A, 12 → EAN-13, 13 → GTIN-14)","operationId":"barkod_kontrol_hanesi","parameters":[{"name":"kod","in":"query","required":true,"schema":{"type":"string","minLength":7,"maxLength":13,"title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/barkod/toplu-dogrula":{"post":{"summary":"Toplu barkod doğrulama (en çok 1000)","operationId":"barkod_toplu_dogrula_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BarcodeBatch"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/barkod/olustur":{"get":{"summary":"Barkod görseli üret (EAN-13, EAN-8, UPC, ITF-14, Code 128/39/93, Data Matrix, PDF417, Aztec)","operationId":"barkod_olustur","parameters":[{"name":"kod","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":1000,"description":"İçerik (sayısal türlerde kontrol hanesi eklenir)","title":"Kod"},"description":"İçerik (sayısal türlerde kontrol hanesi eklenir)"},{"name":"tur","in":"query","required":false,"schema":{"type":"string","description":"ean13, ean8, upca, upce, itf14, code128, code39, code93, codabar, datamatrix, pdf417, aztec","default":"ean13","title":"Tur"},"description":"ean13, ean8, upca, upce, itf14, code128, code39, code93, codabar, datamatrix, pdf417, aztec"},{"name":"bicim","in":"query","required":false,"schema":{"type":"string","description":"svg, png, webp","default":"svg","title":"Bicim"},"description":"svg, png, webp"},{"name":"olcek","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Çizgi kalınlığı (px)","default":3,"title":"Olcek"},"description":"Çizgi kalınlığı (px)"},{"name":"yazi","in":"query","required":false,"schema":{"type":"boolean","description":"Altına okunur numara (EAN/UPC/Code)","default":true,"title":"Yazi"},"description":"Altına okunur numara (EAN/UPC/Code)"},{"name":"cikti","in":"query","required":false,"schema":{"type":"string","description":"dosya ya da json","default":"dosya","title":"Cikti"},"description":"dosya ya da json"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/barkod/sorgula":{"get":{"summary":"Barkoddan ürün bilgisi (ad, marka, kategori, görsel, içindekiler, besin değerleri)","operationId":"barkod_sorgula","parameters":[{"name":"kod","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":14,"description":"EAN-13 / EAN-8 / UPC barkodu","title":"Kod"},"description":"EAN-13 / EAN-8 / UPC barkodu"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/barkod/ara":{"get":{"summary":"Ürün adına göre ara (gıda; Open Food Facts)","operationId":"barkod_ara","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"title":"Q"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/bilgi":{"get":{"summary":"Numara bilgisi: geçerlilik, ülke, tür (cep/sabit/0850/444), biçimler, ilk operatör, maske","operationId":"telefon_bilgi","parameters":[{"name":"numara","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":40,"description":"0532 123 45 67, +90532…, 00 49…","title":"Numara"},"description":"0532 123 45 67, +90532…, 00 49…"},{"name":"ulke","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)","default":"TR","title":"Ulke"},"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/dogrula":{"get":{"summary":"Numara geçerli mi? (kısa yanıt)","operationId":"telefon_dogrula","parameters":[{"name":"numara","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":40,"title":"Numara"}},{"name":"ulke","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)","default":"TR","title":"Ulke"},"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/formatla":{"get":{"summary":"Numarayı E.164, uluslararası, ulusal ve RFC 3966 biçimine çevir","operationId":"telefon_formatla","parameters":[{"name":"numara","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":40,"title":"Numara"}},{"name":"ulke","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)","default":"TR","title":"Ulke"},"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/maskele":{"get":{"summary":"Numarayı maskele (+90 532 *** ** 67)","operationId":"telefon_maskele","parameters":[{"name":"numara","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":40,"title":"Numara"}},{"name":"ulke","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)","default":"TR","title":"Ulke"},"description":"Numara + ile başlamıyorsa varsayılan ülke (ISO 3166, ör. TR, DE)"},{"name":"gorunur_son","in":"query","required":false,"schema":{"type":"integer","maximum":4,"minimum":0,"description":"Sonda görünen hane sayısı","default":2,"title":"Gorunur Son"},"description":"Sonda görünen hane sayısı"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/toplu-dogrula":{"post":{"summary":"Toplu numara doğrulama ve biçimlendirme (en çok 1000)","operationId":"telefon_toplu_dogrula_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/ulke-kodlari":{"get":{"summary":"Ülke telefon kodları (+90, +49…) ve örnek cep numarası","operationId":"telefon_ulke_kodlari","parameters":[{"name":"ara","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ülke kodu, adı ya da +kod","title":"Ara"},"description":"Ülke kodu, adı ya da +kod"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telefon/ulke/{kod}":{"get":{"summary":"Ülkenin numara biçimi: alan kodu öneki, örnek numaralar (türlere göre)","operationId":"telefon_ulke_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/eticaret":{"get":{"summary":"Pazaryeri satışı: komisyon, kargo, hizmet bedeli, stopaj, KDV, hakediş ve kâr","operationId":"hesapla_eticaret","parameters":[{"name":"fiyat","in":"query","required":true,"schema":{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0,"description":"Tüketicinin ödediği KDV dahil satış fiyatı","title":"Fiyat"},"description":"Tüketicinin ödediği KDV dahil satış fiyatı"},{"name":"komisyon","in":"query","required":true,"schema":{"type":"number","maximum":100,"minimum":0,"description":"Komisyon oranı (%), kategoriye göre","title":"Komisyon"},"description":"Komisyon oranı (%), kategoriye göre"},{"name":"kdv","in":"query","required":false,"schema":{"type":"number","maximum":30,"minimum":0,"description":"Ürün KDV oranı (%)","default":20,"title":"Kdv"},"description":"Ürün KDV oranı (%)"},{"name":"komisyon_matrahi","in":"query","required":false,"schema":{"type":"string","pattern":"^(kdv_dahil|kdv_haric)$","description":"Komisyon KDV dahil fiyattan mı hesaplanıyor","default":"kdv_dahil","title":"Komisyon Matrahi"},"description":"Komisyon KDV dahil fiyattan mı hesaplanıyor"},{"name":"kargo","in":"query","required":false,"schema":{"type":"number","maximum":1000000.0,"minimum":0,"description":"Kargo bedeli (KDV hariç)","default":0,"title":"Kargo"},"description":"Kargo bedeli (KDV hariç)"},{"name":"hizmet_bedeli","in":"query","required":false,"schema":{"type":"number","maximum":1000000.0,"minimum":0,"description":"Platform hizmet / işlem bedeli (KDV hariç)","default":0,"title":"Hizmet Bedeli"},"description":"Platform hizmet / işlem bedeli (KDV hariç)"},{"name":"diger","in":"query","required":false,"schema":{"type":"number","maximum":10000000.0,"minimum":0,"description":"Diğer gider: reklam, ambalaj… (KDV hariç)","default":0,"title":"Diger"},"description":"Diğer gider: reklam, ambalaj… (KDV hariç)"},{"name":"maliyet","in":"query","required":false,"schema":{"type":"number","maximum":1000000000.0,"minimum":0,"description":"Ürün alış maliyeti (KDV hariç)","default":0,"title":"Maliyet"},"description":"Ürün alış maliyeti (KDV hariç)"},{"name":"maliyet_kdv","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":30,"minimum":0},{"type":"null"}],"description":"Alış KDV oranı (varsayılan ürün KDV'si)","title":"Maliyet Kdv"},"description":"Alış KDV oranı (varsayılan ürün KDV'si)"},{"name":"stopaj","in":"query","required":false,"schema":{"type":"number","maximum":20,"minimum":0,"description":"E-ticaret stopajı (%; GVK 94/A, KDV hariç tutardan)","default":1.0,"title":"Stopaj"},"description":"E-ticaret stopajı (%; GVK 94/A, KDV hariç tutardan)"},{"name":"hizmet_kdv","in":"query","required":false,"schema":{"type":"number","maximum":30,"minimum":0,"description":"Komisyon / kargo / hizmet faturası KDV oranı","default":20,"title":"Hizmet Kdv"},"description":"Komisyon / kargo / hizmet faturası KDV oranı"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hesapla/eticaret/fiyat":{"get":{"summary":"Hedef kâr ya da kâr marjı için gereken satış fiyatı (komisyon dahil)","operationId":"hesapla_eticaret_fiyat","parameters":[{"name":"komisyon","in":"query","required":true,"schema":{"type":"number","maximum":99,"minimum":0,"title":"Komisyon"}},{"name":"maliyet","in":"query","required":true,"schema":{"type":"number","maximum":1000000000.0,"minimum":0,"title":"Maliyet"}},{"name":"hedef_kar","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0},{"type":"null"}],"description":"Ürün başına kâr (TL)","title":"Hedef Kar"},"description":"Ürün başına kâr (TL)"},{"name":"hedef_marj","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":95,"minimum":0},{"type":"null"}],"description":"ya da KDV hariç satışa göre kâr marjı (%)","title":"Hedef Marj"},"description":"ya da KDV hariç satışa göre kâr marjı (%)"},{"name":"kdv","in":"query","required":false,"schema":{"type":"number","maximum":30,"minimum":0,"default":20,"title":"Kdv"}},{"name":"komisyon_matrahi","in":"query","required":false,"schema":{"type":"string","pattern":"^(kdv_dahil|kdv_haric)$","default":"kdv_dahil","title":"Komisyon Matrahi"}},{"name":"kargo","in":"query","required":false,"schema":{"type":"number","maximum":1000000.0,"minimum":0,"default":0,"title":"Kargo"}},{"name":"hizmet_bedeli","in":"query","required":false,"schema":{"type":"number","maximum":1000000.0,"minimum":0,"default":0,"title":"Hizmet Bedeli"}},{"name":"diger","in":"query","required":false,"schema":{"type":"number","maximum":10000000.0,"minimum":0,"default":0,"title":"Diger"}},{"name":"stopaj","in":"query","required":false,"schema":{"type":"number","maximum":20,"minimum":0,"default":1.0,"title":"Stopaj"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kargo/desi":{"get":{"summary":"Kargo desisi ve ücretlendirilecek ağırlık (en × boy × yükseklik ÷ 3000)","operationId":"kargo_desi","parameters":[{"name":"en","in":"query","required":true,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"description":"cm","title":"En"},"description":"cm"},{"name":"boy","in":"query","required":true,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"description":"cm","title":"Boy"},"description":"cm"},{"name":"yukseklik","in":"query","required":true,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"description":"cm","title":"Yukseklik"},"description":"cm"},{"name":"agirlik","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000,"minimum":0},{"type":"null"}],"description":"Gerçek ağırlık (kg)","title":"Agirlik"},"description":"Gerçek ağırlık (kg)"},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Adet"}},{"name":"kapsam","in":"query","required":false,"schema":{"type":"string","pattern":"^(yurtici|yurtdisi)$","default":"yurtici","title":"Kapsam"}},{"name":"bolen","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1000},{"type":"null"}],"description":"Firmanın böleni (varsayılan 3000 / 5000)","title":"Bolen"},"description":"Firmanın böleni (varsayılan 3000 / 5000)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dogrula/vkn":{"get":{"summary":"Vergi kimlik numarası (10 hane) algoritma doğrulaması","operationId":"dogrula_vkn","parameters":[{"name":"vkn","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":10,"title":"Vkn"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dogrula/tckn":{"get":{"summary":"T.C. kimlik / yabancı kimlik numarası (11 hane) algoritma doğrulaması","operationId":"dogrula_tckn","parameters":[{"name":"tckn","in":"query","required":true,"schema":{"type":"string","minLength":11,"maxLength":11,"title":"Tckn"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dogrula/vergi-no":{"get":{"summary":"VKN (10) ya da TCKN (11, şahıs mükellefi) — uzunluğa göre doğrular","operationId":"dogrula_vergi_no","parameters":[{"name":"no","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":11,"title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dogrula/toplu":{"post":{"summary":"Toplu VKN / TCKN doğrulama (uzunluğa göre; en çok 1000)","operationId":"dogrula_toplu_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdBatch"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulasim/havalimanlari":{"get":{"summary":"Havalimanları: ad / şehir / IATA / ICAO araması, ülke ve il süzgeci","operationId":"ulasim_havalimanlari","parameters":[{"name":"ara","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"Ad, şehir, IATA ya da ICAO","title":"Ara"},"description":"Ad, şehir, IATA ya da ICAO"},{"name":"ulke","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO kodu ya da ad; boş = dünya","default":"TR","title":"Ulke"},"description":"ISO kodu ya da ad; boş = dünya"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Türkiye'de il","title":"Il"},"description":"Türkiye'de il"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(buyuk|orta|kucuk)$"},{"type":"null"}],"title":"Tur"}},{"name":"tarifeli","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Yalnızca tarifeli seferi olanlar","title":"Tarifeli"},"description":"Yalnızca tarifeli seferi olanlar"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulasim/havalimanlari/yakin":{"get":{"summary":"Koordinata ya da konuma en yakın havalimanları","operationId":"ulasim_havalimanlari_yakin","parameters":[{"name":"enlem","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"title":"Enlem"}},{"name":"boylam","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"title":"Boylam"}},{"name":"konum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl / ilçe slug'ı (ör. duzce-akcakoca)","title":"Konum"},"description":"İl / ilçe slug'ı (ör. duzce-akcakoca)"},{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il"}},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ilce"}},{"name":"tarifeli","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Tarifeli"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":5,"title":"Limit"}},{"name":"yaricap","in":"query","required":false,"schema":{"type":"number","maximum":5000,"exclusiveMinimum":0,"description":"km","default":500,"title":"Yaricap"},"description":"km"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulasim/havalimanlari/mesafe":{"get":{"summary":"İki havalimanı arası kuş uçuşu mesafe, yön ve yaklaşık uçuş süresi","operationId":"ulasim_havalimanlari_mesafe","parameters":[{"name":"nereden","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":4,"description":"IATA ya da ICAO","title":"Nereden"},"description":"IATA ya da ICAO"},{"name":"nereye","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":4,"title":"Nereye"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ulasim/havalimanlari/{kod}":{"get":{"summary":"IATA / ICAO koduyla havalimanı","operationId":"ulasim_havalimanlari_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/konumlar/mesafe":{"get":{"summary":"İki nokta arası kuş uçuşu mesafe ve yön (koordinat, il/ilçe slug'ı ya da havalimanı kodu)","operationId":"konumlar_mesafe","parameters":[{"name":"nereden","in":"query","required":true,"schema":{"type":"string","description":"enlem,boylam | il/ilçe slug'ı | IATA","title":"Nereden"},"description":"enlem,boylam | il/ilçe slug'ı | IATA"},{"name":"nereye","in":"query","required":true,"schema":{"type":"string","description":"enlem,boylam | il/ilçe slug'ı | IATA","title":"Nereye"},"description":"enlem,boylam | il/ilçe slug'ı | IATA"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arac/vin":{"get":{"summary":"Şasi numarası (VIN) çözümle: üretici, marka, model yılı, fabrika, gövde, yakıt; kontrol hanesi","operationId":"arac_vin","parameters":[{"name":"vin","in":"query","required":true,"schema":{"type":"string","minLength":11,"maxLength":25,"description":"17 karakterlik şasi numarası","title":"Vin"},"description":"17 karakterlik şasi numarası"},{"name":"ayrinti","in":"query","required":false,"schema":{"type":"boolean","description":"NHTSA vPIC'ten üretici / model bilgisi (yoksa yalnızca yerel denetim)","default":true,"title":"Ayrinti"},"description":"NHTSA vPIC'ten üretici / model bilgisi (yoksa yalnızca yerel denetim)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cevir/yaziyla":{"get":{"summary":"Sayıyı yazıya çevir: tutar (TL, USD, EUR…), fatura biçimi, sıra sayısı","operationId":"cevir_yaziyla","parameters":[{"name":"tutar","in":"query","required":true,"schema":{"type":"string","maxLength":40,"description":"Sayı: 1250,50 · 1250.50 · 1.250,50","title":"Tutar"},"description":"Sayı: 1250,50 · 1250.50 · 1.250,50"},{"name":"para","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":5},{"type":"null"}],"description":"TRY (TL), USD, EUR, GBP, CHF; düz sayı için boş bırakın","default":"TRY","title":"Para"},"description":"TRY (TL), USD, EUR, GBP, CHF; düz sayı için boş bırakın"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/is-gunu/ekle":{"get":{"summary":"N iş günü sonrası / öncesi: hafta sonu, resmî tatil ve bayramlar atlanır","operationId":"takvim_is_gunu_ekle","parameters":[{"name":"gun","in":"query","required":true,"schema":{"type":"integer","maximum":2500,"minimum":-2500,"description":"İş günü sayısı; eksi değer geriye sayar","title":"Gun"},"description":"İş günü sayısı; eksi değer geriye sayar"},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Başlangıç (YYYY-AA-GG), varsayılan bugün; sayılmaz","title":"Tarih"},"description":"Başlangıç (YYYY-AA-GG), varsayılan bugün; sayılmaz"},{"name":"cumartesi","in":"query","required":false,"schema":{"type":"boolean","description":"Cumartesi iş günü sayılsın mı (6 günlük çalışma)","default":false,"title":"Cumartesi"},"description":"Cumartesi iş günü sayılsın mı (6 günlük çalışma)"},{"name":"arife","in":"query","required":false,"schema":{"type":"string","pattern":"^(is_gunu|tatil)$","description":"Yarım gün tatiller (arifeler, 28 Ekim): is_gunu (öğleden önce çalışılır) ya da tatil","default":"is_gunu","title":"Arife"},"description":"Yarım gün tatiller (arifeler, 28 Ekim): is_gunu (öğleden önce çalışılır) ya da tatil"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/takvim/is-gunu/say":{"get":{"summary":"İki tarih arasındaki iş günü sayısı ve aradaki tatiller","operationId":"takvim_is_gunu_say","parameters":[{"name":"baslangic","in":"query","required":true,"schema":{"type":"string","format":"date","description":"YYYY-AA-GG","title":"Baslangic"},"description":"YYYY-AA-GG"},{"name":"bitis","in":"query","required":true,"schema":{"type":"string","format":"date","description":"YYYY-AA-GG","title":"Bitis"},"description":"YYYY-AA-GG"},{"name":"cumartesi","in":"query","required":false,"schema":{"type":"boolean","description":"Cumartesi iş günü sayılsın mı (6 günlük çalışma)","default":false,"title":"Cumartesi"},"description":"Cumartesi iş günü sayılsın mı (6 günlük çalışma)"},{"name":"arife","in":"query","required":false,"schema":{"type":"string","pattern":"^(is_gunu|tatil)$","description":"Yarım gün tatiller (arifeler, 28 Ekim): is_gunu (öğleden önce çalışılır) ya da tatil","default":"is_gunu","title":"Arife"},"description":"Yarım gün tatiller (arifeler, 28 Ekim): is_gunu (öğleden önce çalışılır) ya da tatil"},{"name":"baslangic_dahil","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Baslangic Dahil"}},{"name":"bitis_dahil","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Bitis Dahil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/daireler":{"get":{"summary":"Vergi daireleri: il, ilçe ya da ada göre; muhasebe birim kodlarıyla (GİB)","operationId":"vergi_daireler","parameters":[{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı ya da plaka","title":"Il"},"description":"İl adı ya da plaka"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe adı (büyükşehirde merkez daireleri de bakılır)","title":"Ilce"},"description":"İlçe adı (büyükşehirde merkez daireleri de bakılır)"},{"name":"ara","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":60},{"type":"null"}],"description":"Ad, ilçe ya da kod","title":"Ara"},"description":"Ad, ilçe ya da kod"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(mudurluk|sube|defterdarlik)$"},{"type":"null"}],"title":"Tur"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/daireler/{kod}":{"get":{"summary":"Muhasebe birim koduna göre vergi dairesi","operationId":"vergi_daireler_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/araclar/metin":{"get":{"summary":"Türkçe metin: BÜYÜK / küçük harf (i-İ, ı-I), Başlık, cümle, ASCII, slug, sayım","operationId":"araclar_metin","parameters":[{"name":"metin","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2000,"title":"Metin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Türkçe metin dönüşümü (uzun metin, POST gövdesi)","operationId":"araclar_metin_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/araclar/metin/sirala":{"post":{"summary":"Türk alfabesine göre sırala (ç, ğ, ı, ö, ş, ü doğru yerde)","operationId":"araclar_metin_sirala_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SortBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/baraj":{"get":{"summary":"Baraj doluluk özeti: Türkiye ortalaması, en dolu / en boş barajlar; il verilirse ilin barajları","operationId":"baraj","parameters":[{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı ya da plaka","title":"Il"},"description":"İl adı ya da plaka"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/baraj/liste":{"get":{"summary":"Barajlar: il, havza, doluluk aralığına göre; doluluk ya da ada göre sıralı","operationId":"baraj_liste","parameters":[{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı ya da plaka","title":"Il"},"description":"İl adı ya da plaka"},{"name":"havza","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Havza adının bir kısmı (ör. Sakarya)","title":"Havza"},"description":"Havza adının bir kısmı (ör. Sakarya)"},{"name":"en_az","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":150,"minimum":0},{"type":"null"}],"title":"En Az"}},{"name":"en_cok","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":150,"minimum":0},{"type":"null"}],"title":"En Cok"}},{"name":"siralama","in":"query","required":false,"schema":{"type":"string","pattern":"^(ad|doluluk|doluluk_azalan)$","default":"ad","title":"Siralama"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/baraj/iller":{"get":{"summary":"İllere göre ortalama baraj doluluğu ve baraj sayısı","operationId":"baraj_iller","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/baraj/{slug}":{"get":{"summary":"Baraj ayrıntısı: doluluk, hacim, kot, kurulu güç, amaç, konum ve 30 günlük seyir","operationId":"baraj_slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/baraj/{slug}/gecmis":{"get":{"summary":"Baraj doluluk geçmişi (günlük, kendi arşivimizden)","operationId":"baraj_slug_gecmis","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"gun","in":"query","required":false,"schema":{"type":"integer","maximum":730,"minimum":1,"default":90,"title":"Gun"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/elektrik/kesinti":{"get":{"summary":"Planlı (7 gün) ve plansız (dün + bugün, arıza) elektrik kesintileri: il, ilçe, mahalle, saat, neden","operationId":"elektrik_kesinti","parameters":[{"name":"il","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl adı ya da plaka","title":"Il"},"description":"İl adı ya da plaka"},{"name":"ilce","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Ilce"}},{"name":"mahalle","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Mahalle adının bir kısmı","title":"Mahalle"},"description":"Mahalle adının bir kısmı"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(planli|plansiz)$"},{"type":"null"}],"title":"Tur"}},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"YYYY-AA-GG; o gün süren kesintiler","title":"Tarih"},"description":"YYYY-AA-GG; o gün süren kesintiler"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/elektrik/ptf":{"get":{"summary":"Piyasa takas fiyatı (PTF): saatlik TL / USD / EUR, günlük ortalama, en yüksek / düşük","operationId":"elektrik_ptf","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"YYYY-AA-GG (varsayılan bugün; yarın ~14:00'ten sonra)","title":"Tarih"},"description":"YYYY-AA-GG (varsayılan bugün; yarın ~14:00'ten sonra)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/elektrik/piyasa":{"get":{"summary":"Enerji piyasası özeti: PTF, SMF ve sistem yönü, gün içi fiyat (GİP), doğalgaz spot fiyatı (GRF)","operationId":"elektrik_piyasa","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/elektrik/uretim":{"get":{"summary":"Gerçek zamanlı elektrik üretimi: kaynak dağılımı (doğalgaz, rüzgâr, güneş…), yenilenebilir payı","operationId":"elektrik_uretim","parameters":[{"name":"saatlik","in":"query","required":false,"schema":{"type":"boolean","description":"Günün tüm saatleri","default":false,"title":"Saatlik"},"description":"Günün tüm saatleri"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/elektrik/tuketim":{"get":{"summary":"Gerçek zamanlı elektrik tüketimi (saatlik, MWh; ~2 saat gecikmeli)","operationId":"elektrik_tuketim","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/guvenlik/zararli-kontrol":{"get":{"summary":"Alan adı, URL ya da IP USOM zararlı bağlantı listesinde mi?","operationId":"guvenlik_zararli_kontrol","parameters":[{"name":"adres","in":"query","required":true,"schema":{"type":"string","maxLength":2000,"description":"Alan adı (ornek.com), URL ya da IP adresi","title":"Adres"},"description":"Alan adı (ornek.com), URL ya da IP adresi"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/guvenlik/zararli/son":{"get":{"summary":"Son eklenen zararlı adresler (oltalama, zararlı yazılım, komuta kontrol)","operationId":"guvenlik_zararli_son","parameters":[{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(alan_adi|url|ip|ip6|ip6_ag)$"},{"type":"null"}],"title":"Tur"}},{"name":"kategori","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2},{"type":"null"}],"description":"PH, BP, MD, MI, MU, MC","title":"Kategori"},"description":"PH, BP, MD, MI, MU, MC"},{"name":"gun","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":30,"minimum":1},{"type":"null"}],"description":"Son kaç gün","title":"Gun"},"description":"Son kaç gün"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/guvenlik/bildirimler":{"get":{"summary":"Siber Güvenlik Başkanlığı güvenlik bildirimleri (zafiyet duyuruları, CVE)","operationId":"guvenlik_bildirimler","parameters":[{"name":"etiket","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"Ürün / etiket (ör. WordPress)","title":"Etiket"},"description":"Ürün / etiket (ör. WordPress)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/son":{"get":{"summary":"Son yayımlanan Resmî Gazete (mükerrerler dahil, tüm maddeler)","operationId":"resmigazete_son","parameters":[{"name":"ilanlar","in":"query","required":false,"schema":{"type":"boolean","description":"İlan bölümü bağlantıları da gelsin","default":false,"title":"Ilanlar"},"description":"İlan bölümü bağlantıları da gelsin"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/bugun":{"get":{"summary":"Bugünkü Resmî Gazete","operationId":"resmigazete_bugun","parameters":[{"name":"ilanlar","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Ilanlar"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/tarih/{tarih}":{"get":{"summary":"Tarihteki Resmî Gazete (YYYY-AA-GG)","operationId":"resmigazete_tarih_tarih","parameters":[{"name":"tarih","in":"path","required":true,"schema":{"type":"string","format":"date","title":"Tarih"}},{"name":"ilanlar","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Ilanlar"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/sayi/{sayi}":{"get":{"summary":"Sayı numarasıyla Resmî Gazete (ör. 33419)","operationId":"resmigazete_sayi_sayi","parameters":[{"name":"sayi","in":"path","required":true,"schema":{"type":"integer","title":"Sayi"}},{"name":"ilanlar","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Ilanlar"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/liste":{"get":{"summary":"Türe / kuruma / tarih aralığına göre maddeler (yeniden eskiye)","operationId":"resmigazete_liste","parameters":[{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle tür kodları: kanun, khk, cb_kararnamesi, cb_karari, genelge, yonetmelik, teblig, karar, tbmm_karari, andlasma, atama, yonerge, statu, yargi, ilan, diger","title":"Tur"},"description":"Virgülle tür kodları: kanun, khk, cb_kararnamesi, cb_karari, genelge, yonetmelik, teblig, karar, tbmm_karari, andlasma, atama, yonerge, statu, yargi, ilan, diger"},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/kanunlar":{"get":{"summary":"Kanunlar (yeniden eskiye)","description":"Kanunlar (yeniden eskiye)","operationId":"resmigazete_kanunlar","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/kararnameler":{"get":{"summary":"Cumhurbaşkanlığı kararnameleri ve KHK'ler","description":"Cumhurbaşkanlığı kararnameleri ve KHK'ler","operationId":"resmigazete_kararnameler","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/cb-kararlari":{"get":{"summary":"Cumhurbaşkanı (eskiden Bakanlar Kurulu) kararları","description":"Cumhurbaşkanı (eskiden Bakanlar Kurulu) kararları","operationId":"resmigazete_cb_kararlari","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/yonetmelikler":{"get":{"summary":"Yönetmelikler","description":"Yönetmelikler","operationId":"resmigazete_yonetmelikler","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/tebligler":{"get":{"summary":"Tebliğler","description":"Tebliğler","operationId":"resmigazete_tebligler","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/genelgeler":{"get":{"summary":"Genelgeler","description":"Genelgeler","operationId":"resmigazete_genelgeler","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/kararlar":{"get":{"summary":"Kurul / ilke kararları","description":"Kurul / ilke kararları","operationId":"resmigazete_kararlar","parameters":[{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/ara":{"get":{"summary":"Başlıkta ya da tam metinde arama (tür, kurum, tarih süzgeci)","operationId":"resmigazete_ara","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":200,"description":"Kelimeler (hepsi geçmeli), \"tam ifade\", -hariç","title":"Q"},"description":"Kelimeler (hepsi geçmeli), \"tam ifade\", -hariç"},{"name":"kapsam","in":"query","required":false,"schema":{"type":"string","pattern":"^(baslik|tum)$","description":"baslik ya da tum (başlık + metin)","default":"baslik","title":"Kapsam"},"description":"baslik ya da tum (başlık + metin)"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle tür kodları: kanun, khk, cb_kararnamesi, cb_karari, genelge, yonetmelik, teblig, karar, tbmm_karari, andlasma, atama, yonerge, statu, yargi, ilan, diger","title":"Tur"},"description":"Virgülle tür kodları: kanun, khk, cb_kararnamesi, cb_karari, genelge, yonetmelik, teblig, karar, tbmm_karari, andlasma, atama, yonerge, statu, yargi, ilan, diger"},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"baslangic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Baslangic"}},{"name":"bitis","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Bitis"}},{"name":"sirala","in":"query","required":false,"schema":{"type":"string","pattern":"^(tarih|ilgi)$","default":"tarih","title":"Sirala"}},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":1,"title":"Sayfa"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/madde/{madde_id}":{"get":{"summary":"Madde ayrıntısı (HTML maddelerde düz metin)","operationId":"resmigazete_madde_madde_id","parameters":[{"name":"madde_id","in":"path","required":true,"schema":{"type":"integer","title":"Madde Id"}},{"name":"metin","in":"query","required":false,"schema":{"type":"boolean","description":"Düz metin dahil","default":true,"title":"Metin"},"description":"Düz metin dahil"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/yeni":{"get":{"summary":"Takip: son_id'den sonra arşive giren yeni maddeler (son 10 gün; düzenli yoklama için)","operationId":"resmigazete_yeni","parameters":[{"name":"son_id","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Önceki yanıttaki son_id","default":0,"title":"Son Id"},"description":"Önceki yanıttaki son_id"},{"name":"tur","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Virgülle tür kodları: kanun, khk, cb_kararnamesi, cb_karari, genelge, yonetmelik, teblig, karar, tbmm_karari, andlasma, atama, yonerge, statu, yargi, ilan, diger","title":"Tur"},"description":"Virgülle tür kodları: kanun, khk, cb_kararnamesi, cb_karari, genelge, yonetmelik, teblig, karar, tbmm_karari, andlasma, atama, yonerge, statu, yargi, ilan, diger"},{"name":"kurum","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Kurum"}},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Adet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/resmigazete/turler":{"get":{"summary":"Madde türleri, sayıları ve arşiv kapsamı","operationId":"resmigazete_turler","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/vergi/kurallar":{"get":{"tags":["vergi"],"summary":"Sürümlü vergi kuralları listesi","operationId":"vergi_kurallar","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/vergi/kurallar/{kod}":{"get":{"tags":["vergi"],"summary":"Bir kuralın tüm sürümleri (yürürlük tarihleri ve dayanakları)","operationId":"vergi_kurallar_kod","parameters":[{"name":"kod","in":"path","required":true,"schema":{"type":"string","title":"Kod"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/kdv":{"get":{"tags":["vergi"],"summary":"KDV hesabı: hariç ↔ dahil, isteğe bağlı kısmi tevkifat","operationId":"vergi_kdv","parameters":[{"name":"tutar","in":"query","required":true,"schema":{"type":"number","maximum":1000000000000.0,"exclusiveMinimum":0,"title":"Tutar"}},{"name":"oran","in":"query","required":false,"schema":{"type":"number","maximum":100,"minimum":0,"default":20,"title":"Oran"}},{"name":"dahil","in":"query","required":false,"schema":{"type":"boolean","description":"Tutar KDV dahil mi","default":false,"title":"Dahil"},"description":"Tutar KDV dahil mi"},{"name":"tevkifat","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tevkifat kalemi kodu (/v1/vergi/kdv/tevkifat)","title":"Tevkifat"},"description":"Tevkifat kalemi kodu (/v1/vergi/kdv/tevkifat)"},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/kdv/oranlar":{"get":{"tags":["vergi"],"summary":"Tarihte geçerli KDV oranları","operationId":"vergi_kdv_oranlar","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/kdv/tevkifat":{"get":{"tags":["vergi"],"summary":"KDV kısmi tevkifat kalemleri ve oranları","operationId":"vergi_kdv_tevkifat","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/stopaj":{"get":{"tags":["vergi"],"summary":"Gelir vergisi stopajı (GVK 94): brütten nete ya da netten brüte","operationId":"vergi_stopaj","parameters":[{"name":"tutar","in":"query","required":true,"schema":{"type":"number","maximum":1000000000000.0,"exclusiveMinimum":0,"title":"Tutar"}},{"name":"tur","in":"query","required":true,"schema":{"type":"string","description":"Kalem kodu (/v1/vergi/stopaj/oranlar)","title":"Tur"},"description":"Kalem kodu (/v1/vergi/stopaj/oranlar)"},{"name":"net","in":"query","required":false,"schema":{"type":"boolean","description":"Tutar net mi (brüte iblağ)","default":false,"title":"Net"},"description":"Tutar net mi (brüte iblağ)"},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/stopaj/oranlar":{"get":{"tags":["vergi"],"summary":"Tarihte geçerli stopaj oranları","operationId":"vergi_stopaj_oranlar","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/damga":{"get":{"tags":["vergi"],"summary":"Damga vergisi: nispi (azami tutarla) ya da maktu","operationId":"vergi_damga","parameters":[{"name":"tur","in":"query","required":true,"schema":{"type":"string","description":"Kağıt türü kodu (/v1/vergi/damga/oranlar)","title":"Tur"},"description":"Kağıt türü kodu (/v1/vergi/damga/oranlar)"},{"name":"tutar","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"Nispi kağıtta kağıttaki tutar","title":"Tutar"},"description":"Nispi kağıtta kağıttaki tutar"},{"name":"nusha","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":1,"title":"Nusha"}},{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/damga/oranlar":{"get":{"tags":["vergi"],"summary":"Tarihte geçerli damga vergisi oranları, maktu tutarlar ve azami tutar","operationId":"vergi_damga_oranlar","parameters":[{"name":"tarih","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün","title":"Tarih"},"description":"Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/gelir":{"get":{"tags":["vergi"],"summary":"Gelir vergisi tarifesi; matrah verilirse vergi","operationId":"vergi_gelir","parameters":[{"name":"matrah","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000000.0,"minimum":0},{"type":"null"}],"description":"Yıllık vergi matrahı (TL)","title":"Matrah"},"description":"Yıllık vergi matrahı (TL)"},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(ucret|diger)$","default":"ucret","title":"Tur"}},{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/mtv":{"get":{"tags":["vergi"],"summary":"Motorlu Taşıtlar Vergisi (/v1/hesapla/mtv ile aynı hesap)","operationId":"vergi_mtv","parameters":[{"name":"silindir","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":50},{"type":"null"}],"title":"Silindir"}},{"name":"yas","in":"query","required":true,"schema":{"type":"integer","maximum":100,"minimum":1,"title":"Yas"}},{"name":"deger","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0},{"type":"null"}],"title":"Deger"}},{"name":"tescil","in":"query","required":false,"schema":{"type":"string","pattern":"^(2018_oncesi|2018_sonrasi)$","default":"2018_sonrasi","title":"Tescil"}},{"name":"tur","in":"query","required":false,"schema":{"type":"string","pattern":"^(otomobil|motosiklet|elektrikli|panelvan)$","default":"otomobil","title":"Tur"}},{"name":"guc","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":2000,"minimum":1},{"type":"null"}],"title":"Guc"}},{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2026},{"type":"null"}],"title":"Yil"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vergi/maas":{"get":{"tags":["vergi"],"summary":"Brütten nete maaş (12 aylık bordro) ya da netten brüte","operationId":"vergi_maas","parameters":[{"name":"brut","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"Aylık brüt ücret","title":"Brut"},"description":"Aylık brüt ücret"},{"name":"net","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0},{"type":"null"}],"description":"İstenen aylık net (brüt hesaplanır)","title":"Net"},"description":"İstenen aylık net (brüt hesaplanır)"},{"name":"ay","in":"query","required":false,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"Netten brüte: hangi ayın neti (kümülatif matrah)","default":1,"title":"Ay"},"description":"Netten brüte: hangi ayın neti (kümülatif matrah)"},{"name":"yil","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"title":"Yil"}},{"name":"engelli","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":3,"minimum":1},{"type":"null"}],"description":"Engellilik derecesi (indirim)","title":"Engelli"},"description":"Engellilik derecesi (indirim)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/durum":{"get":{"tags":["durum"],"summary":"Servis ve veri kaynağı durumu","operationId":"durum","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"BarcodeBatch":{"properties":{"kodlar":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Kodlar"}},"type":"object","required":["kodlar"],"title":"BarcodeBatch"},"Batch":{"properties":{"numaralar":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Numaralar","description":"En çok 1000 numara"},"ulke":{"type":"string","maxLength":2,"minLength":2,"title":"Ulke","default":"TR"}},"type":"object","required":["numaralar"],"title":"Batch"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IdBatch":{"properties":{"numaralar":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Numaralar"}},"type":"object","required":["numaralar"],"title":"IdBatch"},"QRBatch":{"properties":{"ogeler":{"items":{"$ref":"#/components/schemas/QRIn"},"type":"array","maxItems":100,"minItems":1,"title":"Ogeler","description":"En çok 100 QR"},"cikti":{"type":"string","title":"Cikti","description":"zip (dosyalar + liste.csv) ya da json","default":"zip"}},"type":"object","required":["ogeler"],"title":"QRBatch"},"QRIn":{"properties":{"tur":{"type":"string","title":"Tur","description":"İçerik türü: url, metin, wifi, vcard, eposta, telefon, sms, konum, whatsapp, iban, sepa, etkinlik","default":"url"},"veri":{"additionalProperties":true,"type":"object","title":"Veri","description":"Türün alanları (GET /v1/araclar/qr/turler)"},"icerik":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icerik","description":"Hazır metin: verilirse tur/veri yok sayılır, olduğu gibi yazılır"},"bicim":{"type":"string","title":"Bicim","description":"png, svg, webp, jpg","default":"png"},"boyut":{"type":"integer","maximum":2048.0,"minimum":64.0,"title":"Boyut","description":"Kenar uzunluğu (px)","default":512},"hata_duzeltme":{"type":"string","title":"Hata Duzeltme","description":"L (%7), M (%15), Q (%25), H (%30); logo varsa H","default":"M"},"renk":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renk","description":"Ön plan #rrggbb (varsayılan siyah)"},"zemin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zemin","description":"Zemin #rrggbb ya da 'transparent' (varsayılan beyaz)"},"kenar":{"type":"integer","maximum":16.0,"minimum":0.0,"title":"Kenar","description":"Sessiz bölge (modül); standart 4","default":4},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Ortaya konacak logo: base64 ya da data:image/…;base64,… (≤300 KB)"},"logo_oran":{"type":"number","maximum":0.3,"minimum":0.1,"title":"Logo Oran","description":"Logonun QR genişliğine oranı","default":0.22},"cikti":{"type":"string","title":"Cikti","description":"json (base64 + data URI) ya da dosya (doğrudan görsel)","default":"json"},"dosya_adi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dosya Adi","description":"Toplu üretimde ZIP içindeki dosya adı"}},"type":"object","title":"QRIn"},"SortBody":{"properties":{"liste":{"items":{"type":"string"},"type":"array","maxItems":5000,"minItems":1,"title":"Liste"},"ters":{"type":"boolean","title":"Ters","default":false},"tekil":{"type":"boolean","title":"Tekil","description":"Tekrarları at (büyük / küçük harf duyarsız)","default":false}},"type":"object","required":["liste"],"title":"SortBody"},"TextBody":{"properties":{"metin":{"type":"string","maxLength":10000,"minLength":1,"title":"Metin"}},"type":"object","required":["metin"],"title":"TextBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Panelde oluşturduğunuz anahtar (va_…). Denemeler anahtarın kotasından düşer."}}},"security":[{"ApiKey":[]}],"servers":[{"url":"https://api.veriapi.pro","description":"Canlı"}]}