Webhook Uç Nokta Kılavuzu

Gelen istek kimlik doğrulaması

iklim.co bir alarmı webhook uç noktanıza ilettiğinde, alarm kaydı sırasında yapılandırdığınız kimlik bilgilerini ekler. Tam mekanizma, seçtiğiniz kimlik doğrulama türüne bağlıdır:

Kimlik doğrulama türü	Kimlik bilgileri nasıl iletilir
Basic	`Authorization: Basic <base64(kullanıcıAdı:şifre)>` başlığı
API Key — başlık olarak	`X-API-Key: <api-anahtarınız>` başlığı
API Key — sorgu parametresi olarak	URL’ye `?apiKey=<api-anahtarınız>` eklenir
JWT	`Authorization: Bearer <jwt-token>` başlığı
HMAC İmzası	`X-Client-Id`, `X-Signature`, `X-HmacAlgorithm`, `X-Timestamp`, `X-Nonce` başlıkları

API Key kimlik doğrulamasını seçtiyseniz, iki iletim modundan (asHeader veya asQueryParameter) yalnızca biri aktif olur — ikisi aynı anda kullanılmaz.

Uç noktanızın yanıtı

Alarm yükünü aldıktan sonra webhook uç noktanız HTTP 200 ve AlarmReceived şemasına uygun bir JSON gövdesi ile yanıt vermelidir. iklim.co, teslimatın başarılı olup olmadığına ya da yeniden denenmesi gerekip gerekmediğine karar vermek için hem HTTP durum kodunu hem de gövde içindeki status alanını değerlendirir.

Beklenen yanıt 💾
Yanıt alanları 📚
HTTP durum kodu matrisi 🔍

{
  "id": "a1b2c3d4-0000-4e5f-9876-000000000001",
  "status": "SUCCESS",
  "timeEpochMillis": 1726286415123
}

Alan	Tip	Açıklama
`id`	string	Alınan alarm yükündeki `id` değerini olduğu gibi geri gönderin. iklim.co bu değeri gönderilen alarmın `id`’si ile karşılaştırır; uyuşmazlık geçici bir hata olarak değerlendirilerek yeniden denemeye yol açar.
`status`	enum	Uç noktanız tarafından bildirilen işlem sonucu (aşağıdaki durum tablosuna bakın).
`timeEpochMillis`	number	Uç noktanızın alarmı işlediği andaki Unix epoch zaman damgası (milisaniye).

`Status` değerleri

Değer	Anlam	iklim.co aksiyonu
`SUCCESS`	Alarm başarıyla alındı ve işlendi.	Yeniden denemeyi durdur, sonraki alarma geç.
`CANCELLED`	Sisteminiz bu alarm için teslimatı reddetti.	Yeniden denemeyi durdur, sonraki alarma geç.
`FAILURE`	Sizin tarafınızda geçici bir hata oluştu (ör. bağımlı servis kullanılamıyor).	Yeniden deneme politikasını uygula.
`TIMEOUT`	Uç noktanız alarmı işlerken dahili zaman aşımına uğradı.	Yeniden deneme politikasını uygula.
`UNKNOWN`	Nedeni belirsiz beklenmedik bir durum oluştu.	Yeniden deneme politikasını uygula.

iklim.co, HTTP durum kodunu yanıt gövdesini incelemeden önce değerlendirir. 2xx dışındaki yanıtlar gövde düzeyinde değerlendirmeye ulaşmaz.

HTTP	Gövde durumu	Neden	Aksiyon
200	`SUCCESS`	Başarıyla işlendi	Yeniden denemeyi durdur
200	`CANCELLED`	Uç nokta teslimatı reddetti	Yeniden denemeyi durdur
200	`FAILURE`	Alıcı tarafında geçici hata	Yeniden dene
200	`TIMEOUT`	Alıcı tarafında zaman aşımı	Yeniden dene
200	`UNKNOWN`	Alıcı tarafında beklenmedik hata	Yeniden dene
200	id uyuşmazlığı veya null gövde	Korelasyon kontrolü başarısız	Yeniden dene
400	—	Yük bozuk veya eksik alanlar var	Yeniden dene
401	—	Yetkilendirme geçersiz veya eksik	Yeniden denemeyi durdur
403	—	Erişim reddedildi	Yeniden denemeyi durdur
404	—	Uç nokta kaynağı bulunamadı	Yeniden denemeyi durdur
405	—	HTTP yöntemi desteklenmiyor	Yeniden denemeyi durdur
429	—	Hız limiti aşıldı	Yeniden dene
500	—	Sunucu tarafında beklenmedik hata	Yeniden dene
502	—	Geçersiz yukarı yön yanıtı	Yeniden dene
503	—	Servis geçici olarak kullanılamıyor	Yeniden dene
504	—	Yukarı yön ağ geçidi zaman aşımı	Yeniden dene

Başlamadan Önce

Webhook Alarmları

MCP Sunucusu

Kimlik Doğrulama & Kullanıcılar

Hesaplar

Yıldırım/Şimşek

Fırtına

Yağış

Tahminler

Nokta Alarm API

Coğrafi Alan Alarm API

Tahnin Alarm API

Güzergah API

Gelen istek kimlik doğrulaması

Uç noktanızın yanıtı

`Status` değerleri

​Gelen istek kimlik doğrulaması

​Uç noktanızın yanıtı

​Status değerleri

Gelen istek kimlik doğrulaması

Uç noktanızın yanıtı

`Status` değerleri