Ana içeriğe atla
PATCH
/
v1
/
alarms
/
forecasts
/
update
Kayıt güncelle
curl --request PATCH \
  --url https://api.iklim.co/v1/alarms/forecasts/update \
  --header 'Content-Type: application/json' \
  --data '
{
  "registrationId": "f7587d9e-2481-4b4c-818d-c8d1946851b7",
  "recipientId": "customer-system-001",
  "boundary": {
    "cityId": 6,
    "districtId": 557,
    "type": "ADMINISTRATIVE"
  },
  "forecastDays": 3,
  "forecastAlarmDelivery": [
    "MORNING",
    "EVENING"
  ],
  "webhook": {
    "accountId": "2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1",
    "url": "https://api.customer.com/alerts/forecast-callback",
    "httpMethod": "POST",
    "contentType": "application/json",
    "authentication": {
      "type": "API_KEY",
      "username": "alert-user",
      "password": "******"
    },
    "requestHeaders": {
      "source": "iklim.co",
      "custom-header": "value"
    },
    "deliveryPolicy": {
      "timeout": 60,
      "maxRetries": 3,
      "retryDelay": 10
    }
  },
  "filter": {
    "precipitationThreshold": "MODERATE",
    "snowFallThreshold": "LIGHT",
    "windGustThreshold": "STRONG_WIND",
    "hotTemperatureThreshold": "HOT_SNAP",
    "coldTemperatureThreshold": "COLD_SNAP"
  }
}
'
{
  "registrationId": "f7587d9e-2481-4b4c-818d-c8d1946851b7",
  "recipientId": "customer-system-001",
  "boundary": {
    "cityId": 6,
    "districtId": 557
  },
  "forecastDays": 3,
  "forecastAlarmDelivery": [
    "MORNING",
    "EVENING"
  ],
  "webhook": {
    "accountId": "2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1",
    "url": "https://api.customer.com/alerts/forecast-callback",
    "httpMethod": "POST",
    "contentType": "application/json",
    "authentication": {
      "username": "alert-user",
      "password": "******"
    },
    "requestHeaders": {
      "source": "iklim.co",
      "custom-header": "value"
    },
    "deliveryPolicy": {
      "timeout": 60,
      "maxRetries": 3,
      "retryDelay": 10
    }
  },
  "filter": {
    "precipitationThreshold": "MODERATE",
    "snowFallThreshold": "LIGHT",
    "windGustThreshold": "STRONG_WIND",
    "hotTemperatureThreshold": "HOT_SNAP",
    "coldTemperatureThreshold": "COLD_SNAP"
  },
  "createdAt": "2025-01-01T10:15:30Z",
  "updatedAt": "2025-01-01T11:15:30Z",
  "warnings": [
    "warning-1",
    "warning-2"
  ]
}

Gövde

application/json

Tahmin nokta alarmı kaydı.

​
registrationId
string<uuid>

Kayıtın UUID değeri (güncelleme işlemleri için zorunludur).

Örnek:

"f7587d9e-2481-4b4c-818d-c8d1946851b7"

​
recipientId
string

Bildirim alıcısı için çağrıran tarafın tanımladığı harici referans tanımlayıcısı.

Örnek:

"customer-system-001"

​
boundary
object

Alarm kayıt sınırı

Tahmin alarm koşulları için izlenecek coğrafi kapsamı tanımlar. Somut sınır türü type ayırt edici alanıyla seçilir; yalnızca seçilen alt türe ait alanlar gönderilmelidir.

  • ADMINISTRATIVE – il (cityId) ve ilçe (districtId) sayısal kimlik değerleriyle tanımlanan idari sınır; her iki alan da zorunludur.
  • POINT – tek bir boylam/enlem koordinatı (point) ile tanımlanan coğrafi nokta sınırı. Alarm, o koordinata en yakın tahmin ızgara hücresi için değerlendirme yapar.
​
forecastDays
integer<int32>

Alarm koşulları değerlendirilecek ileriki tahmin gün sayısı (1–14).

Örnek:

3

​
forecastAlarmDelivery
enum<string>[]

Alarm bildirimlerinin gönderildiği zaman dilimleri (MORNING – 04:00 UTC, EVENING – 16:00 UTC).

Mevcut seçenekler:
MORNING,
EVENING
Örnek:
["MORNING", "EVENING"]
​
webhook
object

Bu kayıt için dışa çağrı (callback) yapılandırması.

​
filter
object

Hangi tahmin koşullarının alarm tetikleyeceğini denetleyen eşik filtreleri.

Yanıt

Başarılı

​
registrationId
string<uuid>

Kayıtın UUID değeri (güncelleme işlemleri için zorunludur).

Örnek:

"f7587d9e-2481-4b4c-818d-c8d1946851b7"

​
recipientId
string

Bildirim alıcısı için çağrıran tarafın tanımladığı harici referans tanımlayıcısı.

Örnek:

"customer-system-001"

​
boundary
object

Alarm kayıt sınırı

Tahmin alarm koşulları için izlenecek coğrafi kapsamı tanımlar. Somut sınır türü type ayırt edici alanıyla seçilir; yalnızca seçilen alt türe ait alanlar gönderilmelidir.

  • ADMINISTRATIVE – il (cityId) ve ilçe (districtId) sayısal kimlik değerleriyle tanımlanan idari sınır; her iki alan da zorunludur.
  • POINT – tek bir boylam/enlem koordinatı (point) ile tanımlanan coğrafi nokta sınırı. Alarm, o koordinata en yakın tahmin ızgara hücresi için değerlendirme yapar.
​
forecastDays
integer<int32>

Alarm koşulları değerlendirilecek ileriki tahmin gün sayısı (1–14).

Örnek:

3

​
forecastAlarmDelivery
enum<string>[]

Alarm bildirimlerinin gönderildiği zaman dilimleri (MORNING – 04:00 UTC, EVENING – 16:00 UTC).

Mevcut seçenekler:
MORNING,
EVENING
Örnek:
["MORNING", "EVENING"]
​
webhook
object

Bu kayıt için dışa çağrı (callback) yapılandırması.

​
filter
object

Hangi tahmin koşullarının alarm tetikleyeceğini denetleyen eşik filtreleri.

​
createdAt
string<date-time>

Kaydın ilk oluşturulduğu zaman damgası (ISO-8601).

Örnek:

"2025-01-01T10:15:30Z"

​
updatedAt
string<date-time>

Kaydın en son güncellendiği zaman damgası (ISO-8601).

Örnek:

"2025-01-01T11:15:30Z"

​
warnings
string[]

Kayıt işleme sırasında oluşturulan kritik olmayan uyarılar.

Örnek:
["warning-1", "warning-2"]