API Dokümantasyonu

Temel adres

https://bvakp-od-portal.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://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search?resource_id=<kaynak-id>

Parametreler

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

Çalışan örnekler

Aşağıdaki örnekler şu veri setinin gerçek kaynağı üzerinde çalışır: otomasyon_onay_veri_seti_20260929_201051_274 (49 satır).

curl

curl -s "https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search?resource_id=b810f8d5-a1b1-4c46-bde6-4c0c30f81790&limit=5"

Sıralama ve sayfalama

curl -s "https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search?resource_id=b810f8d5-a1b1-4c46-bde6-4c0c30f81790&sort=yil%20desc&limit=10&offset=10"

Süzme

curl -s -G "https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search" \
  --data-urlencode "resource_id=b810f8d5-a1b1-4c46-bde6-4c0c30f81790" \
  --data-urlencode 'filters={"yil": "2019"}'

Tam metin arama

curl -s -G "https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search" \
  --data-urlencode "resource_id=b810f8d5-a1b1-4c46-bde6-4c0c30f81790" \
  --data-urlencode "q=2019"

Python

import requests

response = requests.get(
    "https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search",
    params={"resource_id": "b810f8d5-a1b1-4c46-bde6-4c0c30f81790", "limit": 5},
    timeout=30,
)
payload = response.json()
for record in payload["result"]["records"]:
    print(record)

JavaScript

const url = new URL("https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/datastore_search");
url.searchParams.set("resource_id", "b810f8d5-a1b1-4c46-bde6-4c0c30f81790");
url.searchParams.set("limit", "5");

const response = await fetch(url);
const { result } = await response.json();
console.table(result.records);

Yanıt şeması

Örnek veri setinin alanları

Tüm veriyi indirme

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

GET https://bvakp-od-portal.buyukverianalitigi.com/datastore/dump/<kaynak-id>?format=csv
GET https://bvakp-od-portal.buyukverianalitigi.com/datastore/dump/<kaynak-id>?format=json
GET https://bvakp-od-portal.buyukverianalitigi.com/datastore/dump/<kaynak-id>?format=xml
GET https://bvakp-od-portal.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ı

Katalog sorgulama

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

GET https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/package_search?q=istasyon&rows=10
GET https://bvakp-od-portal.buyukverianalitigi.com/api/3/action/package_show?id=<veri-seti-adı>
GET https://bvakp-od-portal.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://bvakp-od-portal.buyukverianalitigi.com/api/3/action/package_search?fq=groups:ulasim