API Builder oluşturulduktan sonra açılan ekranda sağ üst köşede yer alan ADD NEW METHOD Butonuna tıklayıp isimlendirme yaparak API Builder Method oluşturmaya başlayın. Method oluştururken sağ tarafta Properties paneli yer almaktadır. Properties panelini kullanarak yetkilendirme ve aksiyon ekleme işlemlerini gerçekleştirebilirsiniz. İstediğiniz zaman oluşturduğunuz methodları silebilir veya yeniden adlandırabilirsiniz.
Properties panelinde Authorization, Actions, Method Inputs alanları yer almaktadır.
Authorization
API hizmetini yetkilendirme vererek açılması All Roles Access ile herhangi doğrulama istemeden kullanım için Anonymous Access seçeneği kullanılmaktadır.
Add Actions
Method çağrıldığında platform tarafında çalışması istenilen aksiyonların eklendiği alandır.
Method Input
Kullanılacak aksiyonlar input değerleri barındırıyorsa bu değerlerin tipi, ismi vs özelliklerin girildiği alandır.
Örnek bir senaryo üzerinde API method yapısı ele alınabilir. Örneğin, içerisinde menü olan bir uygulama olduğu varsayılsın. Bu uygulama içerisinde Barcode numarası input olarak verilsin. Durum kodu responsive olarak geri döndürürsün.
İlk olarak uygulama içerisinde yer alan UI Design modülünde Custom Actions paneli üzerinden veya Datasources modülüne veri kaynağına eklediğiniz Actions başlığı altından yeni bir Custom Actions oluşturun. Bu Custom actions ile bir input alıp sonuç olarak responsive bir değer döndürecektir.
Açılan SQL Editör içerisinde istenilen sorguları manual olarak yazabilir veya yapay zeka yardımı ile kolaylıkla sorgu ekleyebilirsiniz.
SQL editör içerisine
Copyselect Barcode Statu from Menu
Where Barcode = @Barcode
gibi sorgular eklendikten sonra status inquiry gibi isimlendirip CREATE butonuna tıklayın. Oluşturulan aksiyonu API Method içerisine çağırmak için +ADD ACTION’a tıklayın. Arama çubuğuna status inquiry (oluşturduğunuz aksiyon) yazarak aksiyonu ekleyin.Oluşturulan aksiyon parametresi Symbol Picker aracılığıyla Action Results → status inquiry (oluşturduğunuz aksiyon) şeklinde doldurulmalıdır.
SQL Editör içerisinde @ işareti ile tanımlanan Barcode parametresi dışarı açılan API olduğundan dolayı bir Method Input’un oluşturulması gerekmektedir. Method Input’un oluşturulması için + ADD METHOD INPUT’a tıklayın. Input Name alanına @ ile yazılan parametre yani Barcode yazın. Input tipini Guid seçip Create butonuna tıklayın.
Oluşturulan aksiyon dışarıdan parametre alıp yazılan SQL sorgularını almaya hazır durumdadır. Yapılan işlemleri test edebilmek için Preview butonuna tıklayın. Sonuç olarak preview sonucunda URL kısmına Swagger yazarak son yapılan API ve eklenen method işlemlerini görüntüleyebilirsiniz. İşlemleri Sign in yapıp görüntülenmesini veya herkesin görüntüleyebilmesini Properties panelinden Authorization alanından ayarlayabilirsiniz.
