Araştırıyorum · API
Açık API: koşullar ve anahtar
Kısa cevap
Su Haritası açık API'si anahtarsız 60 istek/dk ile herkese açıktır. Akademik ve gazetecilik kullanımı için ücretsiz anahtar 600 istek/dk ve günde 20.000 istek verir. Başvuru e-postayla: [email protected]. Lisans CC BY 4.0; atıf "Su Haritası (suharitasi.com)".
Anahtarsız ve anahtarlı kullanım
| Anahtarsız | Anahtarlı | |
|---|---|---|
| Kimler | herkes | başvuran kurum/proje (akademik ve gazetecilik ücretsiz; kamu, sivil toplum ve kişisel kullanım da ücretsiz; ticari kullanımda yalnız atıf koşulu) |
| Sınır | 60 istek/dk (IP + tarayıcı başına), Function uçlarında | 600 istek/dk ve günde 20.000 istek (anahtar başına) |
| Nasıl | doğrudan GET | Authorization: Bearer sh_… ya da X-Api-Anahtar: sh_… başlığı (sorgu dizesinde anahtar kabul edilmez: günlüklere düşer) |
| Kota aşımı | 429 + Retry-After | 429; günlük kota aşılırsa anahtar 24 saat kendiliğinden kısıtlanır, iptal edilmez |
| Durum sorgusu | — | GET /api/anahtar-durum (aynı başlıkla): bugünkü kullanım, kalan kota, kısıt |
Statik veri dosyaları (/veri/*.json, v2 uçları) CDN'den sunulur ve anahtar gerektirmez; anahtar yalnız Function uçlarında (/api/v1/havzalar, /api/v1/kuraklik) sınırı yükseltir. MCP ucu anonim kalır.
Anahtar başvurusu
- [email protected] adresine kurum/proje adı, kullanım amacı (akademik, gazetecilik, kamu, sivil toplum, ticari, kişisel) ve tahmini günlük istek sayısıyla yazın.
- Anahtar e-postayla bir kez iletilir; sunucuda saklanmaz (yalnız özeti tutulur). Kaybolursa yenisi üretilir, eskisi iptal edilir.
- Anahtar kişiye değil projeye bağlıdır; paylaşım kullanım kotasını ortak tüketir.
Kullanım koşulu
- Lisans: Su Haritası derlemesi CC BY 4.0. Kaynak verileri (EPİAŞ, DSİ, NASA GRACE, UCSB CHIRPS, Resmî Gazete, mevzuat.gov.tr) kendi koşullarına tabidir; her yanıtın
meta.kaynak/kaynaklaralanı bunu söyler. - Atıf: "Su Haritası (suharitasi.com)", erişim tarihi ve sürüm (
meta.surumya da sayfadaki sürüm). Kişi adı yazılmaz. Kalıcı adres:/kimlik/<kod>/. - Yorum yok: API ölçüm ve derleme döndürür;
/api/v1/kuraklikaçıkça tahmindir (tur: "tahmin"). Değerleri hukuki görüş ya da resmî sınıflama olarak sunmayın. - Kötüye kullanım: sınır aşımı, otomatik kazıma dışı yoğun istek ya da kaynak satırını kaldıran yeniden yayın hâlinde anahtar kısıtlanır ya da iptal edilir; günlüklerde anahtarın kendisi değil kısa kimliği (
ak_…) tutulur. - Gizlilik: erişim günlüğü IP, uç, durum kodu ve kısa kimlik tutar; 30 gün sonra silinir (gizlilik). Anahtar başvurusunda yalnız proje adı ve amaç kaydedilir.
- Süreklilik: v1 uçları korunur; değişiklikler değişiklik günlüğünde duyurulur. Garanti ya da hizmet seviyesi taahhüdü yoktur.
Örnek
curl -s -H "Authorization: Bearer sh_XXXX" https://suharitasi.com/api/v1/havzalar | head -c 400
curl -s -H "Authorization: Bearer sh_XXXX" https://suharitasi.com/api/anahtar-durumBelgeler: API dokümantasyonu · OpenAPI · geliştirici kapısı.