Penman-Monteith ET₀, Idso-Jackson CWSI, NDVI, Saxton-Rawls toprak fiziği ve etkin yağış hesabını bir REST endpoint'i ile çağırın. JSON in / JSON out. Sandbox 5 dakikada hazır.
# FAO-56 sulama tahmini — tek POST curl -X POST https://api.esular.com/v1/predict \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "lat": 36.89, "lon": 30.71, "crop": "tomato", "growthStage": "mid", "soilType": "loam", "rootDepthM": 0.6, "currentMoisture": 0.22, "lastIrrigationDate": "2026-05-04" }' # Yanıt: { "et0_mm": 5.8, "kc_adjusted": 1.18, "etc_mm": 6.84, "raw_mm": 38.0, "deficit_mm": 23.0, "recommendation": { "action": "irrigate", "grossIrrigation_mm": 28.0, "durationMinutes": 18, "scheduledFor": "2026-05-10T06:30:00Z" }, "forecast": { "rainfallNext7d_mm": 12.4 } }
// SDK Q3 2026 — şimdilik fetch/axios ile import { VisionClient } from '@esular/vision'; const esular = new VisionClient({ apiKey: process.env.ESULAR_API_KEY }); const result = await esular.predict({ lat: 36.89, lon: 30.71, crop: 'tomato', growthStage: 'mid', soilType: 'loam', rootDepthM: 0.6, currentMoisture: 0.22, lastIrrigationDate: '2026-05-04' }); console.log(`Sulama: ${result.recommendation.durationMinutes} dk`); console.log(`ET₀: ${result.et0_mm} mm/gün`); console.log(`Açık: ${result.deficit_mm} mm`); // → Sulama: 18 dk // → ET₀: 5.8 mm/gün // → Açık: 23 mm
// SDK Q3 2026 — şimdilik HttpClient ile using Esular.Vision; var esular = new VisionClient(Environment.GetEnvironmentVariable("ESULAR_API_KEY")); var result = await esular.PredictAsync(new PredictRequest { Lat = 36.89, Lon = 30.71, Crop = "tomato", GrowthStage = GrowthStage.Mid, SoilType = "loam", RootDepthM = 0.6, CurrentMoisture = 0.22, LastIrrigationDate = DateTime.Parse("2026-05-04") }); Console.WriteLine($"Sulama: {result.Recommendation.DurationMinutes} dk"); Console.WriteLine($"ET₀: {result.Et0Mm} mm/gün"); Console.WriteLine($"Açık: {result.DeficitMm} mm");
# SDK Q3 2026 — şimdilik requests ile from esular_vision import VisionClient esular = VisionClient(api_key=os.environ["ESULAR_API_KEY"]) result = esular.predict( lat=36.89, lon=30.71, crop="tomato", growth_stage="mid", soil_type="loam", root_depth_m=0.6, current_moisture=0.22, last_irrigation_date="2026-05-04", ) print(f"Sulama: {result.recommendation.duration_minutes} dk") print(f"ET₀: {result.et0_mm} mm/gün") print(f"Açık: {result.deficit_mm} mm")
Karmaşık agronomi mantığını kendiniz yazmak yerine tek HTTP çağrısı ile alın. Bakım, kalibrasyon, güncelleme — hepsi bizde.
Sıfırdan motor yazma. Tek paket kurun, ilk istekte sonuç. SDK + sandbox + dokümantasyon hazır.
SLA'lı uptime, idempotent endpoint'ler, otomatik retry — production'da huzurla çalışır.
Yeni bitki, kalibrasyon, iklim verisi güncellemeleri — siz dokunmadan otomatik gelir.
JSON request / response · API Key + JWT authentication · interaktif dokümantasyon Swagger UI üzerinden (/swagger).
İnteraktif dokümantasyon: kurulu API üzerinde /swagger yoluyla erişilir.
Roadmap: Webhooks · Batch endpoint · Excel/PDF I/O · ayrı hesap endpoint'leri (CWSI, Saxton-Rawls, LR)
Bearer token ile authentication. API Key ile X-Api-Key header'ı veya JWT ile
Authorization: Bearer şeklinde gönderilir.
Tüm endpoint'leri tarayıcıdan deneyin. Request / response şemaları, parametre açıklamaları, authentication kurulumu Swagger UI'dan yönetilir.
Şu an kullanımda olan REST API'nin üzerine eklenmesi planlanan özellikler:
Polling yerine push. irrigation.recommended, stress.detected, forecast.rain.soon gibi olay türlerine abone olabilme.
Tek istekte birden fazla parsel için paralel hesap. Tarım danışmanları + kooperatif yönetim panelleri için.
Parsel listesi + toprak analiz raporu Excel/CSV import. FAO-56 hesap raporu PDF export (hibe başvuruları için).
.NET, JavaScript / TypeScript, Python paketleri. Şu an REST direkt kullanım — herhangi bir HTTP client ile çalışır.
WhatsApp'tan sandbox key talep edin. 1.000 ücretsiz çağrı / ay.
https://wa.me/905412474505?text=Sandbox%20API%20key%20istiyorum
Herhangi bir HTTP kütüphanesi ile çalışır. SDK paketleri Q3 2026'da gelecek; şimdilik REST direkt.
fetch / HttpClient / requests / curl — Authorization: Bearer YOUR_KEY
Lat / Lon + bitki + toprak. Sonuç: sulama önerisi.
esular.predict({ lat: 36.89, lon: 30.71, crop: 'tomato', ... })
POST /webhooks ile abone olun, signing secret'ınızla doğrulayın.
POST /v1/webhooks { url: 'https://app.you.com/hooks/esular', events: ['irrigation.recommended'] }
Sandbox'ta entegrasyon hazır olduğunda WhatsApp'tan production key alın.
Authorization: Bearer sk_live_***
Şu an REST API doğrudan kullanıma hazır (curl / fetch / HttpClient ile). Resmi SDK paketleri 2026 üçüncü çeyrekte yayınlanacak. Erken erişim için listeye yazılın.
dotnet add package Esular.Vision
Async + Source Gen
npm i @esular/vision
TypeScript types
pip install esular-vision
Async + Pydantic
go get github.com/esular/vision-go
Context + retry
SDK çıkınca haber alın → erken erişim listesine yazılın.
Mevcut sensör platformunuza FAO-56 katmanı ekleyin. Sensör verisi → /predict → mobil bildirim.
Çiftlik yönetim yazılımınıza sulama planlama modülü ekleyin. Excel'den çık, otomatikleş.
Mevcut hava verisi servisinize agronomi katmanı ekleyin. Müşteriniz hem hava hem ET hesabını alsın.
White-label çiftçi uygulamanızı 1 ay yerine 1 hafta içinde çıkarın. UI sizin, motor Esular.
Tezinize, makaleye, AR-GE projesine FAO-56 referans hesabı ekleyin. Akademik kullanımda ücretsiz tier.
Belediye park-bahçe sulama optimizasyonu. Şehir genelinde 500+ noktayı tek API ile takip.
Sürüm dönüşü, dokümantasyon, KVKK uyumu — production'da gerekenler.
SemVer. /v1 yolu altında breaking change yapmıyoruz. Yeni endpoint eklenebilir, mevcutlar değişmez. v2 çıkarsa öncesinden duyurulur.
Tüm endpoint'ler Swagger UI üzerinden tarayıcıdan denenebilir. Request / response şemaları, parametre detayları, authentication kurulumu tek yerde.
KVKK uyumlu veri işleme. API Key veya JWT Bearer ile authentication. HTTPS zorunlu, hassas header'lar log'lanmaz.
Hesap motoru güncellemeleri (Kc tablosu, bitki kalibrasyonu, yeni standart) changelog olarak duyurulur. Geriye dönük uyumluluk korunur.
Akademik kullanım, açık kaynak proje, hackathon, öğrenci projesi → her zaman ücretsiz. WhatsApp'tan kanıtla yazın.
Evet. WhatsApp'tan sandbox key talep ettikten sonra ayda 1.000 ücretsiz çağrı hakkı verilir. Production API key için ticari görüşme gerekir. Sandbox key ile gerçek hesap motoruna erişirsiniz, sadece çağrı limiti vardır.
Şu an REST API doğrudan kullanıma hazır — herhangi bir HTTP client (curl, fetch, HttpClient, requests) ile entegre edebilirsiniz. Resmi SDK paketleri (.NET, JavaScript/TS, Python, Go) 2026 üçüncü çeyrekte yayınlanacak. Erken erişim listesine yazılırsanız çıktığında haber veririz.
Her webhook isteği X-Esular-Signature header'ı ile imzalanır (HMAC-SHA256, your webhook secret). İstek gövdesini secret ile hash'leyip karşılaştırarak orijinalliğini doğrulayabilirsiniz. SDK'lar bu doğrulamayı otomatik yapar (esular.webhooks.verify(req)).
Sandbox 60 req/dakika, Pro 600 req/dakika, Enterprise sınırsız (fair-use). Limitler her endpoint için ayrı sayılır. 429 yanıtında Retry-After header'ı dönülür. Tüm SDK'lar otomatik exponential backoff retry yapar.
Evet. https://api.esular.com/v1/openapi.json adresinde public ve sürekli güncel. Postman, Insomnia, Stoplight, Swagger UI ve OpenAPI Generator ile uyumlu. Kendi dilinizde client kodu üretebilirsiniz.
POST isteklerinizde Idempotency-Key header'ı kullanın (UUID4 önerilir). Network kesintisinde aynı key ile retry'da aynı yanıt cache'ten döner — duplicate kayıt oluşmaz. Key'ler 24 saat saklanır.
Enterprise plan kapsamında Docker image olarak on-prem deployment mevcut. Air-gapped ortamlarda çalışır, lisans dosyasıyla doğrulama. Geçerli müşteriler: askeri/güvenlik kurumları, kapalı endüstriyel SCADA ortamları.
SemVer. Path'te /v1 olduğu sürece breaking change YOK. v2 çıkacaksa 12 ay önceden duyurulur, v1 en az 3 yıl daha desteklenir. Yeni alanlar (additive change) major version değişimi gerektirmez.
Kredi kartı yok. Aboneliğe gerek yok. WhatsApp'tan yazın, anında key.
Talep tipinize göre seçin: