Müşteri · Ayarlar

Webhook ekleme

Siparişlerinizin durumu değişince (teslim alındı, teslim edildi, iptal…) kendi sisteminize otomatik haber gönderen webhook aboneliğini kurma, imza sırrı ve sorun giderme.

Webhook, siparişinizde bir şey olduğunda (ör. kurye paketi aldı, teslim etti) Courino'nun sizin sisteminizdeki bir adrese kendiliğinden haber göndermesidir. Böylece yazılımınız durumu sürekli sormak zorunda kalmaz.

Adresi ve hangi olayların gerekli olduğunu genellikle yazılım geliştiriciniz verir. Bu kartı görmüyorsanız hesabınızda API ve webhook izni yoktur; kurye firmanızdan isteyin.

Abonelik ekleme

Sol menüden Bilgilerim'e basın.
Webhook (olay bildirimi) kartında Abonelik ekle'ye basın.
Adres (https://…) kutusuna geliştiricinizin verdiği adresi yazın. Güvenlik için https:// ile başlayan bir adres kullanın.
Biçim olarak KOS (imzalı JSON) seçili kalsın. Eski sistem (orderId) yalnız eski entegrasyonu değişmeden kullanmak isteyenler içindir.
İsterseniz Açıklama kutusuna bir not yazın (ör. "Depo sistemi").
Olaylar bölümünde haber almak istediğiniz durumları işaretleyin (ör. Teslim alındı, Teslim edildi, İptal edildi).
Etkin işaretli olsun ve Kaydet'e basın.
Yeşil kutuda imza sırrı görünür (whsec_ ile başlar). Kopyala ile alıp geliştiricinize güvenli yoldan iletin.

İmza sırrı yalnızca bir kez gösterilir. Kaybederseniz aboneliğin yanındaki Sırrı yenile ile yenisini alın; eski sır o anda geçersiz olur.

Gönderilen haber

Her haber JSON biçimindedir ve siparişin numarasını, durumunu, zamanlarını, referans numaranızı, tutarını ve kuryenin adını içerir. Alıcının telefonu gibi kişisel bilgiler gönderilmez.
Her haber X-KOS-Signature başlığıyla imzalanır. Geliştiriciniz bu imzayı sırla doğrulayarak haberin gerçekten Courino'dan geldiğini anlar.
Adresiniz yanıt vermezse ya da hata dönerse haber artan aralıklarla birkaç kez (toplam yaklaşık 1,5 saat) yeniden denenir. Aynı haberin tekrarında X-KOS-Delivery değeri değişmez; geliştiriciniz ikinciyi atlayabilir.
Teslim kodu, değerlendirme isteği ve "kuryeniz yolda" iletileri yalnız alıcıya gider; webhook ile gönderilmez.

Geliştiriciniz imzanın nasıl doğrulanacağını kartın üstündeki API dokümanı'nda bulur. Ayrıntılar Entegrasyon API'si yazısında.

Aboneliği yönetme

Düzenle: Adresi, olayları ya da açıklamayı değiştirir. Haberleri geçici durdurmak için Etkin işaretini kaldırın.
Sırrı yenile: Yeni imza sırrı üretir. Sırrın başkasının eline geçtiğinden şüphelenirseniz kullanın ve yeni sırrı geliştiricinize iletin.
Sil: Aboneliği tamamen kaldırır.
En çok 5 abonelik açabilirsiniz.

Sorun mu var?

Webhook kartı görünmüyor: Hesabınıza API ve webhook izni verilmemiştir. Kurye firmanıza danışın.
Kaydet'e basınca adres hatası çıkıyor: Adres https:// (ya da http://) ile başlamalı ve içinde kullanıcı adı ya da şifre olmamalıdır.
Haber gelmiyor: Aboneliğin Etkin olduğundan ve doğru olayların işaretli olduğundan emin olun. Adres internetten erişilebilir olmalıdır; şirket içi (yerel ağ) adreslere gönderilmez. Geliştiricinizden adresin 2xx (başarılı) yanıt döndüğünü kontrol etmesini isteyin.
Geliştirici "imza tutmuyor" diyor: Sır eksik ya da yanlış kopyalanmış olabilir. Sırrın tamamı (whsec_ dahil) kullanılmalıdır. Emin değilseniz Sırrı yenile ile yeni sır alın.
Aynı haber iki kez geldi: Yeniden deneme olabilir; geliştiriciniz X-KOS-Delivery değerine bakarak tekrarı atlamalıdır.