API filtreleri, çekirdek uygulamayı değiştirmeden bir API'ye özel mantık eklemenize olanak tanır. Ön filtre, API gelen isteği işlemeden önce çalışır; parametreleri yeniden şekillendirebilir, girişi doğrulayabilir veya bağlam ekleyebilirsiniz. Arka filtre, API sonuçları döndürdükten sonra çalışır; yanıtı dönüştürebilir, zenginleştirebilir veya maskeleyebilirsiniz.
API filtrelerinin çalışma şekli
DataService Studio, Aviator ve Python işlevlerini destekler. DataService Studio kullanarak işlevler oluşturun, işlevleri test edin, yayınlayın ve kullanın. Bir işlevi yayınladıktan sonra bunu filtre olarak kullanmak üzere bir API ile ilişkilendirin. Bu sayede, çekirdek API mantığını değiştirmeden farklı sorgu gereksinimlerini karşılayabilir ve iş senaryolarına uyum sağlayabilirsiniz. Ayrıntılar için bkz. Bir işlevi API filtresi olarak kullanma.
Ön filtre, API çağrıyı işlemeden önce API'nin istek parametrelerini ön işleme tabi tutar.
Arka filtre, API çağrıyı işledikten sonra API'nin döndürdüğü sonuçları dönüştürür.
Yaygın senaryolara yönelik kod örnekleri için bkz. En iyi uygulamalar: Aviator işlevini filtre olarak kullanma.
Gereksinimler
Bir API için ön filtre ve arka filtre aynı işlev türünü kullanmalıdır: Her ikisi de Aviator veya her ikisi de Python olmalıdır. Aynı API'nin ön ve arka filtrelerinde farklı işlev türlerini kullanmak desteklenmez.
-
Güvenlik ve performans nedenleriyle Aviator işlevlerinin bir DataService Studio için özel kaynak grubunda çalışması gerekir.
Bir işlevi düzenlerken veya test ederken buna bir DataService Studio özel kaynak grubu atayın. Daha fazla bilgi için bkz. İşlev oluşturma.
Bir API geliştirirken bir filtreyi etkinleştirip hedef işlevi ilişkilendiriyorsanız API'ye bir DataService Studio özel kaynak grubu atayın. Daha fazla bilgi için bkz. Kodsuz kullanıcı arayüzünde API oluşturma.
Sınırlamalar
Filtre özelliği DataWorks Basic Edition veya sonraki bir sürümü gerektirir.
Python işlevleri yükseltilmektedir. Yeni Python işlevleri oluşturamaz, kopyalayamaz veya yayınlamazsınız. Bunun yerine Aviator işlev türünü kullanın. Daha fazla bilgi için bkz. Aviator işlevi oluşturma.