Developer

API Dokümantasyonu

Tarımİklim servis katmanı REST tabanlıdır ve JSON döndürür. Aşağıdaki örnekler ile canlı tahmin, don riski ve widget entegrasyonunu hızlıca test edebilirsiniz.

Base URL

https://tarimiklim.com/api/v1

Format

JSON (UTF-8)

Rate Limit

60 istek / dakika (free tier)

GET/weather?lat=36.89&lon=30.68&days=7

7 günlük tahmin verisini döndürür.

curl "https://tarimiklim.com/api/v1/weather?lat=36.89&lon=30.68&days=7"

GET/weather/current?lat=36.89&lon=30.68

Anlık hava durumu verisini döndürür.

curl "https://tarimiklim.com/api/v1/weather/current?lat=36.89&lon=30.68"

GET/weather/frost-risk?lat=36.89&lon=30.68

Don riski skoru ve risk günlerini döndürür.

curl "https://tarimiklim.com/api/v1/weather/frost-risk?lat=36.89&lon=30.68"

GET/weather/hourly?lat=36.89&lon=30.68&slots=8

3 saatlik slotlarla saatlik yakın tahmin verir.

curl "https://tarimiklim.com/api/v1/weather/hourly?lat=36.89&lon=30.68&slots=8"

GET/weather/widget-data?location=antalya-merkez

Widget için optimize edilmiş hafif payload döndürür.

curl "https://tarimiklim.com/api/v1/weather/widget-data?location=antalya-merkez"

POST/alerts/subscribe

Bildirim aboneliği örnek endpoint’i (entegrasyon katmanı).

curl -X POST "https://tarimiklim.com/api/v1/alerts/subscribe" \
  -H "Content-Type: application/json" \
  -d '{"location":"antalya-merkez","channel":"telegram","threshold":65}'

Widget Entegrasyonu

Widget bileşenini iframe ile gömebilirsiniz. Aşağıdaki örnekte canlı endpoint doğrudan bu proje üstünden beslenir.

<iframe
  src="https://tarimiklim.com/tr/widget/bereketfide"
  width="360"
  height="210"
  style="border:none;border-radius:14px"
  title="Tarımİklim Widget"
/>