API dokümantasyonu - Konya Büyükşehir Belediyesi Açık Veri Platformu

Genel bakış

Tüm uç noktalar <code>/api/3/action/</code> altındadır ve JSON döndürür. Başarılı yanıt "success": true taşır, veriyi "result" altında verir.

GET https://acikveri-konya.digitalcosmonot.com/api/3/action/package_search?q=trafik&rows=10

Kimlik doğrulama

Okuma uç noktaları herkese açıktır ve anahtar gerektirmez. Yazma işlemleri için profil sayfanızdan bir API token'ı oluşturup Authorization başlığında gönderin.

curl -H "Authorization: <API-TOKEN>" \
  https://acikveri-konya.digitalcosmonot.com/api/3/action/package_create -d @dataset.json

GET /api/3/action/package_search

Katalogdaki veri setlerini Solr sorgu diliyle arar. Sonuçlar sayfalanır; her kayıt veri setinin tüm üstverisini ve kaynak listesini içerir.

Parametreler

Ad	Tip	Açıklama
q	string	Serbest metin sorgusu. Varsayılan `:`
fq	string	Filtre sorgusu, ör. `groups:hareketlilik`
rows	int	Sayfa başına kayıt (en fazla 1000)
start	int	Sayfalama başlangıcı
sort	string	Sıralama, ör. `metadata_modified desc`

Bu uç noktayı dene

GET /api/3/action/package_show

Tek bir veri setini tüm üstverisi ve kaynaklarıyla döndürür.

Parametreler

Ad	Tip	Açıklama
id	string	Veri setinin adı veya kimliği

Bu uç noktayı dene

GET /api/3/action/datastore_search

DataStore'da tutulan bir kaynağın satırlarını sorgular.

Parametreler

Ad	Tip	Açıklama
resource_id	string	Kaynak kimliği
q	string	Tam metin sorgusu
limit	int	Satır sayısı (varsayılan 100)
offset	int	Sayfalama başlangıcı
fields	string	Virgülle ayrılmış sütun listesi

Bu uç noktayı dene

GET /api/3/action/datastore_search_sql

DataStore tabloları üzerinde salt okunur SQL sorgusu çalıştırır.

Parametreler

Ad	Tip	Açıklama
sql	string	SELECT ifadesi; yazma ifadeleri reddedilir

Bu uç noktayı dene

GET /api/3/action/organization_list

Portalda veri yayımlayan organizasyonları listeler.

Parametreler

Ad	Tip	Açıklama
all_fields	bool	Yalnız ad yerine kaydın tamamını döndürür
sort	string	Sıralama, ör. `package_count desc`

Bu uç noktayı dene

GET /api/3/action/group_list

Kategorileri listeler.

Parametreler

Ad	Tip	Açıklama
all_fields	bool	Yalnız ad yerine kaydın tamamını döndürür

Bu uç noktayı dene

GET /api/3/action/tag_list

Katalogda kullanılan etiketleri listeler.

Parametreler

Ad	Tip	Açıklama
query	string	Bu metni içeren etiketleri süzer

Bu uç noktayı dene

Örnek yanıt

{
  "success": true,
  "result": {
    "count": 32,
    "results": [
      {
        "name": "trafik-isiklari-konum-bilgisi",
        "title": "Trafik Işıkları Konum Bilgisi",
        "organization": { "name": "ulasim-dairesi-baskanligi" },
        "license_id": "cc-by",
        "metadata_modified": "2026-03-06T10:54:12",
        "resources": [
          { "format": "CSV", "name": "2025_konya_kavsaklar.csv" },
          { "format": "CSV", "name": "2022_konya_kavsaklar.csv" }
        ]
      }
    ]
  }
}

Hata kodları

400

Geçersiz parametre

404

Kayıt bulunamadı

403

Yetki bulunmamaktadır