Gerçek Zamanlı Bildirimler
Gönderi durumu değişikliklerini anında öğrenin. Webhooks ile sistemlerinizi otomatik senkronize edin.
Nasıl Çalışır?
Webhook URL Ekleyin
Müşteri panelinizden webhook URL'inizi kaydedin.
Olayları Seçin
Hangi olaylar için bildirim almak istediğinizi belirleyin.
Bildirimleri Alın
Seçtiğiniz olaylar gerçekleştiğinde otomatik POST isteği alırsınız.
Mevcut Webhook Olayları
Yeni bir gönderi oluşturulduğunda tetiklenir.
{
"event": "shipment.created",
"data": {
"shipment_id": "SHP_20250115_001234",
"tracking_number": "KE1234567890TR",
"status": "created"
}
}
Kargo kurye tarafından alındığında tetiklenir.
{
"event": "shipment.picked_up",
"data": {
"tracking_number": "KE1234567890TR",
"pickup_date": "2025-11-29T10:30:00Z"
}
}
Kargo transit sürecindeyken konum güncellemelerinde tetiklenir.
{
"event": "shipment.in_transit",
"data": {
"tracking_number": "KE1234567890TR",
"location": "Frankfurt, DE"
}
}
Kargo dağıtıma çıktığında tetiklenir.
{
"event": "shipment.out_for_delivery",
"data": {
"tracking_number": "KE1234567890TR",
"estimated_delivery": "2025-11-29"
}
}
Kargo başarıyla teslim edildiğinde tetiklenir.
{
"event": "shipment.delivered",
"data": {
"tracking_number": "KE1234567890TR",
"delivered_at": "2025-11-29T14:20:00Z",
"signed_by": "John Doe"
}
}
Teslimat sırasında bir sorun oluştuğunda tetiklenir.
{
"event": "shipment.exception",
"data": {
"tracking_number": "KE1234567890TR",
"exception_type": "address_not_found",
"message": "Adres bulunamadı"
}
}
🔒 Güvenlik
Her webhook isteği bir imza (signature) içerir. İsteğin gerçekten KargoEvi'nden geldiğini doğrulamak için bu imzayı kontrol etmeniz önerilir. Detaylı bilgi için API dokümantasyonunu inceleyin.