Entegrasyonlar için API Modülü

Entegrasyonlar için API Modülü, ProjectCore'un dış sistemlerle kurduğu bağlantı katmanıdır. Projeler, görevler, sprintler, talepler ve raporlar programatik olarak okunur ve yazılır; platform kapalı bir ada olmaktan çıkar, kurumun yazılım ekosisteminin bir parçası hâline gelir. Veri tek yönlü aktarılabildiği gibi karşılıklı da akar, böylece iki sistem arasında elle kopyalama adımı ortadan kalkar.

Entegrasyonlar REST API üzerine kuruludur. GET, POST, PUT ve DELETE metodlarıyla kaynaklara erişilir; JSON tabanlı veri biçimi ve standart HTTP yanıt kodları sayesinde çağrı herhangi bir programlama dilinden ve ortamdan yapılabilir. Geliştiriciler tanıdık bir arayüzle çalıştığı için kuruma özel senaryolar uzun analiz dönemlerine ihtiyaç duymadan hayata geçer. Aynı API hem küçük bir bildirim akışında hem de kurumsal ölçekli veri aktarımlarında kullanılır.

Proje yönetimi modülündeki Entegrasyonlar sayfası, dış sistemlerle kurulabilecek bağlantıları bir katalog olarak sunar. Her kart bir entegrasyon adayını tanıtır: ne işe yaradığını ve verinin hangi yönde taşındığını anlatır. Kartlar bir kurulum sihirbazı değil yönlendirmedir; bağlantının kendisi ilgili sistemin ayarlarından yapılır. Katalog, hangi ihtiyacın hazır bir bağlantıyla, hangisinin kendi tanımınızla karşılanacağını tek ekranda gösterir.

Yeni bir bağlantı, Ayarlar ekranındaki Entegrasyonlar sayfasından kurulur. Önce bağlantı kurulacak uygulama seçilir, ardından Yeni Entegrasyon adımına geçilir. Açılan sayfada entegrasyona bir ad verilir; HTTP metodu, istek yapılacak URL ve kimlik doğrulama türü seçilir, entegrasyonun çalışacağı ProjectCore modülü belirlenir ve basit doğrulama seçildiyse kimlik bilgileri doldurulur. Bu tanım, geliştirici desteği olmadan yönetici tarafından yapılabilecek biçimde tasarlanmıştır.

İsteğin gövdesi JSON biçiminde girilir ve "@" işaretiyle seçili modüldeki alanlar gövdeye eklenir; URL ve başlık parametrelerinde key-value çiftleriyle ProjectCore değerleri belirlenen değişkenlere bağlanır. Sonuç değer işaretleme bölümünde ise dönen yanıttaki alanlar ProjectCore alanlarıyla eşleştirilir. Böylece entegrasyon yalnız veri göndermez, geri gelen veriyi de kayda yazar ve iki sistem arasındaki bilgi güncel kalır. Aynı tanım farklı kayıtlar için farklı değerlerle çalıştığından tek bir entegrasyon tüm proje portföyüne hizmet eder.

Tanımlanan entegrasyon, Otomasyon Yönetimi ekranındaki bir kural ile çalıştırılır: Yeni Kural ile açılan tanımın birinci aşamasında modül kategorisi ve tetikleyici durum, ikinci aşamasında koşullar, üçüncü aşamasında çalışacak otomasyon seçilir. Proje içindeki Ayarlar ▸ Otomasyon kuralları da webhook ve HTTP isteği aksiyonlarını destekler; görev şu duruma geçince şu sisteme haber ver türü ihtiyaçlar için ayrı bir entegrasyona gerek kalmaz. Bu aksiyonlar dış adreslere istek attığı için hedef adresin doğruluğu ve gönderilen veride hassas bilgi bulunmaması önceden denetlenmelidir; bir kez gönderilen veri geri alınamaz.

Güvenli erişim tarafında token tabanlı doğrulama, rol bazlı yetki ve kapsam tanımları kullanılır; her uygulama yalnızca ihtiyaç duyduğu kaynağa ulaşır ve erişimler geriye dönük denetlenebilir. Toplu veri alışverişi ise her zaman API gerektirmez: Görevler sekmesindeki araç çubuğundan görev listesi Excel'e aktarılır ve düzenlenip geri yüklenir. Dışa aktarılan dosya seçenekli alanları ve kişi alanlarını okunabilir karşılıklarıyla yazdığı için gidiş-dönüş uyumludur, kişi eşleşmesi e-posta üzerinden çözülür ve iki işlem Görev Dışa Aktarabilir ile Görev İçe Aktarabilir yetkilerine bağlıdır. İçe aktarma satır bazında doğrulama yapıp hatalı satırları raporladığı için toplu güncelleme veriyi bozmadan ilerler.