Entegrasyonlar
İzin verisini kendi sistemlerinize bağlayın
Entegrasyon API'si çalışan, izin, bakiye ve bordro verisini salt okunur olarak sunar. Webhook'lar bir izin onaylandığında ya da iptal edildiğinde sisteminize anında haber verir.
- Kapsamı seçilen API anahtarları
- HMAC-SHA256 ile imzalı webhook'lar
- Başarısız teslimatlarda otomatik yeniden deneme
Salt okunur entegrasyon API'si
Kendi sistemleriniz İzin360'taki verileri JSON olarak okur. Her anahtar yalnız sizin seçtiğiniz kapsamlara erişir.
- Çalışan listesi, izin talepleri, izin bakiyeleri ve bordro dosyası için ayrı kapsamlar
- Bordro dosyası, uygulamadaki bordro aktarımıyla aynıdır (CSV ya da XLSX)
- Çalışan listesi TC kimlik numarası ve ücret bilgisi içermez
- Planınıza göre dakika başına istek sınırı
Güvenli anahtar yönetimi
API anahtarlarını şirket sahibi oluşturur. Anahtar yalnız oluşturulduğu anda gösterilir; kullanılmayan ya da şüpheli bir anahtar tek tıkla iptal edilir.
- İsteğe bağlı son geçerlilik tarihi
- Her anahtarın son kullanım zamanı görünür
- Anahtar sayısı planınıza göre sınırlıdır
İmzalı webhook'lar
Seçtiğiniz olaylar gerçekleştiğinde İzin360 hedef adresinize imzalı bir istek gönderir. Alıcı sisteminiz imzayı ve zaman damgasını doğrular.
- İzin talebi gönderildi, onaylandı, reddedildi, geri çekildi, iptal edildi, izin başladı ve çalışanın çıkışı tamamlandı olayları
- Yalnız HTTPS ile ve internete açık adreslere gönderim
- Başarısız teslimatlar artan aralıklarla yeniden denenir; teslimat geçmişi panelde görünür
- Test olayıyla bağlantıyı önceden deneme
Asgari veri ilkesi
Webhook içeriği yalnız gerekli alanları taşır: kayıt kimlikleri, sicil no, tarihler, gün sayısı ve durum. Ad, e-posta ve gerekçe metni gönderilmez.
- Sağlıkla ilgili izin türleri yalnız “İzinli” olarak gönderilir
- Aynı olay birden fazla gelirse olay kimliğiyle ayıklanır
Kod gerektirmeyen bağlantılar
Her entegrasyon yazılım geliştirme gerektirmez. Çalışan verisi dosyayla aktarılır, izinler takvim uygulamalarında abonelikle görünür.
- Excel ya da CSV ile toplu çalışan aktarımı; dosyanın tamamı önce denetlenir, hatalar satır satır gösterilir
- Kişisel ve ekip iCal aboneliği
- Herkese açık API belgesi: uçlar, örnek yanıtlar ve imza doğrulama örneği
Nasıl çalışır?
- 1
Anahtar oluşturun
Entegrasyonlar ayarında gereken kapsamları seçerek bir API anahtarı oluşturun ve güvenli bir yerde saklayın.
- 2
Webhook ekleyin
Hedef adresinizi ve izlemek istediğiniz olayları seçin; imza sırrını alıcı sisteminize kaydedin.
- 3
Test edip devreye alın
Bir test olayı gönderin, sonucu teslimat geçmişinden kontrol edin ve entegrasyonunuzu çalıştırın.
Sıkça sorulan sorular
API ile İzin360'a veri yazabilir miyiz?
Hayır. Entegrasyon API'si salt okunurdur; çalışan, izin, bakiye ve bordro verisini okumak içindir. Çalışanları toplu eklemek için Excel ya da CSV aktarımını kullanabilirsiniz.
Webhook isteğinin İzin360'tan geldiğini nasıl doğrularız?
Her istek, imza sırrınızla zaman damgası ve istek gövdesi üzerinden hesaplanan bir HMAC-SHA256 imzası taşır. Alıcı sisteminiz imzayı yeniden hesaplayıp karşılaştırır ve eski zaman damgalı istekleri reddeder. Örnek kod herkese açık API belgesinde yer alır.
Hedef sistemimiz geçici olarak kapalıysa olaylar kaybolur mu?
Hayır. Başarısız teslimatlar artan aralıklarla en fazla 8 kez yeniden denenir. Art arda 15 başarısız teslimattan sonra abonelik otomatik olarak kapanır; hedefi düzelttikten sonra panelden yeniden etkinleştirirsiniz.
API hangi kişisel verileri döndürür?
Çalışan listesi sicil no, ad soyad, e-posta, departman, ekip ve işe giriş tarihini içerir; TC kimlik numarası ve ücret bilgisi bu listede yer almaz. Webhook'larda ad ve e-posta da bulunmaz; sağlıkla ilgili izin türleri yalnız “İzinli” olarak gönderilir.
Belirli bir bordro ya da İK yazılımı için hazır entegrasyon var mı?
İzin360 belirli bir ürüne özel hazır bağlantı sunmaz. Bunun yerine her sistemin kullanabileceği standart bir REST API, webhook'lar, CSV/XLSX bordro dosyası ve iCal aboneliği sağlar.
Kendi verilerinizle deneyin
30 gün ücretsiz deneyin; kart bilgisi gerekmez. Sorularınız için demo talep edebilirsiniz.