API Dokümantasyonu

Portaldaki veri setlerine dosya indirmeden, doğrudan HTTP üzerinden erişin. Kimlik doğrulama gerekmez; tüm uç noktalar herkese açık okuma erişimi sunar.

Temel adres

https://ckan.buyukverianalitigi.com/api/3/action/

Tüm yanıtlar UTF-8 JSON’dur ve aynı zarfı kullanır:

{
  "success": true,
  "result": { ... }
}

Hata durumunda "success" false olur ve "error" nesnesi döner. HTTP durum kodu 200 dışında olabilir.

Veri sorgulama — datastore_search

Bir veri setinin satırlarını sorgulamak için kullanılır. Yalnızca DataStore’a yüklenmiş kaynaklar sorgulanabilir; portalda hangi veri setlerinin API ile erişilebildiği aşağıda listelenmiştir.

GET https://ckan.buyukverianalitigi.com/api/3/action/datastore_search?resource_id=<kaynak-id>

Parametreler

Parametre	Açıklama
`resource_id`	Zorunlu. Sorgulanacak kaynağın kimliği.
`limit`	Döndürülecek satır sayısı (varsayılan 100).
`offset`	Atlanacak satır sayısı. limit ile birlikte sayfalama sağlar.
`sort`	Sıralama: alan adı ve yön, ör. `yil desc`. Virgülle birden fazla alan verilebilir.
`filters`	Alan bazlı eşitlik süzgeci; JSON nesnesi, ör. `{"yil":"2025"}`.
`q`	Tam metin arama. Tek bir metin ya da alan bazlı JSON nesnesi olabilir.
`fields`	Yalnızca belirtilen alanları döndürür (virgülle ayrılmış).
`distinct`	true verilirse yinelenen satırlar teke indirilir.

Bu kurulumda SQL ile sorgulama (datastore_search_sql) kapalıdır; süzme ve sıralama yukarıdaki parametrelerle yapılır.

Tüm veriyi indirme

Sayfalama yapmadan bir kaynağın tamamını almak için dump uç noktaları kullanılır:

GET https://ckan.buyukverianalitigi.com/datastore/dump/<kaynak-id>?format=csv
GET https://ckan.buyukverianalitigi.com/datastore/dump/<kaynak-id>?format=json
GET https://ckan.buyukverianalitigi.com/datastore/dump/<kaynak-id>?format=xml
GET https://ckan.buyukverianalitigi.com/datastore/dump-xlsx/<kaynak-id>

XLSX uç noktası bu portala özgüdür; diğer üçü DataStore’un standart çıktısıdır.

Kullanım sınırları

Kimlik doğrulama	Gerekmez. API anahtarı ya da üyelik istenmez.
İzin verilen işlemler	Yalnızca okuma. Veri ekleme, güncelleme ve silme portal dışından kapalıdır.
İstek sınırı	Sorgu uç noktalarında dakikada 60 istek, toplu indirme uç noktalarında dakikada 6 istek (IP başına). Günlük kota yoktur; sınırın amacı sistem kaynaklarını korumaktır.
Sınır aşıldığında	İstek HTTP 429 ile yanıtlanır; yanıtın Retry-After başlığında kaç saniye beklenmesi gerektiği bildirilir.
Tek istekte kayıt	limit parametresi verilmezse varsayılan kayıt sayısı döner; tek istekte çekilebilecek kayıt sayısı sistem tarafından sınırlıdır. Daha fazlası için offset ile sayfalayın ya da toplu indirme uç noktasını kullanın.

Katalog sorgulama

Veri setlerinin kendisini (üstveri) aramak için:

GET https://ckan.buyukverianalitigi.com/api/3/action/package_search?q=istasyon&rows=10
GET https://ckan.buyukverianalitigi.com/api/3/action/package_show?id=<veri-seti-adı>
GET https://ckan.buyukverianalitigi.com/api/3/action/group_list?all_fields=true

package_search, arayüzdeki filtrelerin tamamını destekler; örneğin kategoriye göre:

GET https://ckan.buyukverianalitigi.com/api/3/action/package_search?fq=groups:ulasim