Şehirler

Başlangıç ve kimlik doğrulama Şehirler Namaz vakitleri Finans Hava durumu Puan durumu Fikstür Dünya yerleşim verisi Geçmiş ve arşiv

81 ilin plakası, adı, slug'ı ve koordinatı. Anahtar gerektirmez.

Erişimherkese açıkküme dışı

Uç noktalar1aşağıda tek tek açıklanır

KaynakServisin kendi listesi

TazelemeSabitListe değişmez

Namaz ve hava uçlarının il anahtarı buradan gelir. id alanı plakadır (1–81) ve aynı değer yerleşim verisindeki Türkiye illerinde plaka olarak bulunur; iki kümeyi bu alan üzerinden birleştirebilirsiniz.

Bu uç herkese açıktır: anahtar göndermeden çağırabilirsiniz. Ortak yanıt zarfını (kume, guncelleme, bayat) taşımaz, çünkü tazelenen bir veri değildir.

Uç noktalar

GET/v1/sehirler

81 ilin tamamı, plakaya göre sıralı.

Alanlar

Yanıt

Alan	Tip	Açıklama
`ok`	bool	Her zaman `true`.
`adet`	int	Listedeki il sayısı (81).
`iller`	dizi	İl nesneleri.

iller[] öğesi

Alan	Tip	Açıklama
`id`	int	Plaka (1–81). Namaz ve hava uçlarında il anahtarı olarak kullanılır.
`ad`	string	İlin Türkçe adı (ör. `Afyonkarahisar`).
`slug`	string	Adın ASCII karşılığı (ör. `afyonkarahisar`). İl anahtarı olarak plaka yerine kullanılabilir.
`enlem`	float	Merkez enlemi.
`boylam`	float	Merkez boylamı.

Örnek yanıt

Örnek yanıt · /v1/sehirler

{
  "ok": true,
  "adet": 81,
  "iller": [
    { "id": 1, "ad": "Adana", "slug": "adana",
      "enlem": 37.0, "boylam": 35.32 },
    { "id": 6, "ad": "Ankara", "slug": "ankara",
      "enlem": 39.93, "boylam": 32.86 },
    … 81 kayıt
  ]
}

Kullanım

curl

curl https://api.sanater.com/v1/sehirler

JavaScript · seçim kutusu

const { iller } = await (await fetch('https://api.sanater.com/v1/sehirler')).json();
secim.innerHTML = iller
  .map(i => `<option value="${i.id}">${i.ad}</option>`)
  .join('');

Bilinmesi gerekenler

İl anahtarı isteyen her uçta 42 ile konya aynı sonucu verir; slug'lar Türkçe harf içermez.
Tanınmayan bir il anahtarı 404 döner ve yanıt gövdesinde geçerli örnekler bulunur.

← Tüm belgeler