ESET bulut konsolları uygulama programlama arayüzleri (API)
Değişikliklerin entegrasyonunuzu nasıl etkilediğini anlamak için, gateway ile hizmet verdiği uygulama programlama arayüzü (API) kategorilerini ayırt etmek önemlidir.
ESET Connect (gateway)
ESET Connect tamamen ESET tarafından yönetilen bulut tabanlı bir geçittir. Aşağıdaki ESET bulut hizmetlerinin istemcisi ile arka uç hizmetleri arasında giriş noktası olarak görev yapar:
ESET Connect API Kategorileri
Gateway, belirli API setlerine erişim sağlar ve bu API Kategoriler olarak organize edilir.
Sürümleme |
Her API kategorisinin kendi bağımsız sürüm yaşam döngüsü vardır. Bu, kod bağlantınızda belirttiğiniz sürümdür (örneğin, /v1/groups). |
Darbe |
ESET Connect API Kategorilerine yapılan güncellemeler, API çağrılarını değiştirebilir. |
Kullanım Ömrü Sonu politikası |
Bozuk değişiklikler politikasını
ESET, değişiklik bozulmaz kabul edilirse önceden bildirim almadan değişiklik yapabilir.
|
ESET, bozulma değişikliklerini önceden bildirmek için makul çabalar gösterecek ve bu değişikliklere uyum sağlayacak kadar zamanla. |
Kırılan bir değişiklik, uygulama programlama arayüzlerinde (API'lerde) yapılan bir değişikliktir; bu değişiklikler, entegrasyonunuzda bozulmayı önlemek veya uyumluluğu korumak için değişiklik gerektirebilir.
Aşağıda, değişiklikleri bozduğunu düşündüğümüz birkaç değişiklik örneği verilmiştir:
•yanıt formatı değiştirildi,
•alan yeniden adlandırıldı,
•alan kaldırıldı,
•veri tipi değişikliği,
•hata kodu değişikliği,
•iş mantığı değişimi.
Bozuk değişiklikler, kimlik doğrulama, izin kapsamı, hız sınırları, taşıma/URL değişiklikleri ve diğer faktörlerle ilgili değişikliklerden de kaynaklanabilir.
Kesintisiz bir değişim, kesintisiz ve kendi isteğinizle ve hızınızda uyum sağlayabileceğiniz bir değişikliktir.
Aşağıda, değişiklikleri bozmadığını düşündüğümüz birkaç değişiklik örneği verilmiştir :
•yeni alan eklendi,
•yeni isteğe bağlı parametre eklendi,
•yeni katma değer,
•artan tarife sınırı,
•daha fazla format desteği vb.
Geçiş dönemi
Geçiş döneminde, yeni API Kategorisi versiyonu veya işlevsel değişim getirildikten sonra önceki API Kategorisi sürümünün kullanılabilir kaldığı zaman diliminde, önceki sürüm tanımlanmış, Sınırlı Destek süresi boyunca kullanılabilir olmaya devam eder. ESET, uyumluluğu sağlamak ve müşterilere bu değişikliklere uyum sağlamak için yeterli zaman sağlamak için makul çabalar gösterecektir.
ESET Connect API Kategorileri sürümünün Sınırlı Desteği, genellikle son müşterilere kamuya duyurulma tarihinde duyurulan tarihte başlar. ESET Connect API Kategorileri sürümü Sınırlı Destek bölümüne taşınacak ve Kullanım Süresi Sonuna kadar olan dönem boyunca erişilebilir olacak. Sınırlı Destek süresi sona erdikten sonra, ESET Connect API Kategorileri sürümü artık kullanılmayacaktır.
Sürüm kuralları
Bozuk değişiklikler |
Kesinti değişikliği içeren herhangi bir versiyon dokümantasyonda açıkça işaretlenecektir. |
Kesintisiz Değişiklikler |
Bir sürüm yalnızca bozucu değişiklikler içeriyorsa, API Kategorisi sürümü aynı kalır. Detaylar ESET Connect Online yardım dokümantasyonunda bulunabilir. |