Xpoda Studio’ya giriş yaptıktan sonra sol menüde bulunan API Service alanına tıklayın. Açılan ekranda, yeni bir API koleksiyonu oluşturmak için “Create a new API Collection” ifadesinin hemen üstünde yer alan artı (+) simgesine basın. Bu işlem sonrasında, API Collection’a isim verebileceğiniz küçük bir pencere açılacaktır. Buraya, oluşturacağınız koleksiyonun amacını net şekilde ifade eden bir isim girin ve 'Create and Go' butonu ile onaylayın. Böylece, Asistan ile tetiklenecek API yöntemlerini ekleyebileceğiniz temel koleksiyon oluşturulmuş olur.
Bu örnekte API Collection ismi 'Test for API Assistant' olarak belirlenmiştir. Collection’ın üstüne tıklanır, Request listesi açılır. Bu ekranda API Request tanımlanmış ve ilgili URL eklenmiştir. Bu örnekte, ImdbTop100 adını verdiğimiz API isteği ile IMDb sitesinden en popüler 100 filmi listeleyen bir GET çağrısı yapılmaktadır.
IMDb Top100 isteğine (request) tıklandığında, Request Detail ekranı (API tanımlama ekranı) açılır. Bu ekranda, seçilen API’nin Request Detail alanına gerekli parametreler ve headers bilgileri eklenmiştir. Bu başlıklar, API’nin doğru şekilde çalışabilmesi için girilmesi zorunlu bilgiler içerir.(x-rapidapi-host ve x-rapidapi-key. Bu parametreler, API üzerinden IMDb Top 100 listesini çekmek için zorunludur. x-rapidapi-host alanına API’nin host adresi, x-rapidapi-key alanına ise erişim anahtarı (API key) girilir.)
API’yi tanımladıktan sonra, sonraki adım olarak sol taraftaki menüden Assistant alanına tıklayarak Xpoda Asistan ekranına geçmeniz gerekir. Bu ekranda, Asistan’ın kullanıcı komutlarını nasıl işleyeceğini belirleyebilir, komut (intent) ve tetikleyici (trigger) tanımlarını yaparak az önce oluşturduğunuz API’yi Asistan’a bağlayabilirsiniz. Böylece, Asistan üzerinden verilen komutla API çağrısı otomatik olarak çalıştırılabilir.
Asistan ekranında yeni bir API tanımlamak için öncelikle Name alanına istediğiniz ismi girin. Ardından, Type açılır kutusunu açarak Triggering Api Engine seçeneğini işaretleyin. Bu seçimi yaptığınızda ekran, ikinci görseldeki gibi değişecek ve API Collection ile API Request alanları aktif hale gelecektir. Active kutusunu işaretledikten sonra, daha önce oluşturduğunuz API koleksiyonunu ve çalıştırmak istediğiniz spesifik API isteğini seçin.
Bu örnekte API herhangi bir parametre almadığı için Api Parameters kısmı boş bırakılmıştır.
Api Data Query alanına ise, API’den dönen verilerden hangilerini görmek istediğinizi belirlemek için kendi tablonuzdan çekilecek sorguyu yazabilirsiniz. Örneğimizde kullanılan sorgu:
INSERT INTO dbo.XP_API_IMDB_MOVIE_LIST
(
CreateDate,
CreateUser,
UpdateDate,
UpdateUser,
IntegrationID,
ProjectID,
FormTypeID,
LineNumber,
RecordGuid,
MovieRank,
Title,
ReleaseYear,
ImdbRating,
FilmType,
DirectorName,
MovieLength
)
SELECT
GETDATE() AS CreateDate,
1 AS CreateUser,
GETDATE() AS UpdateDate,
GETDATE() AS UpdateUser,
0 AS IntegrationID,
0 AS ProjectID,
0 AS FormTypeID,
1 AS LineNumber,
NEWID() AS RecordGuid,
rank AS MovieRank,
Series_Title AS Title,
Released_Year AS ReleaseYear,
IMDB_Rating AS ImdbRating,
Genre AS FilmType,
Director AS DirectorName,
CAST(REPLACE(Runtime, ' min', '') AS DECIMAL(5,2)) AS MovieLength
FROM #XPODA_API_TABLE_2;
Bu sorgu, API çağrısı sonucunda geçici olarak oluşturulan #XPODA_API_TABLE_2 tablosundaki bilgileri alarak XP_API_IMDB_MOVIE_LIST tablosuna ekler. Böylece IMDb Top 100 film başlıkları sisteminize kaydedilmiş olur.
API’nin hangi periyotlarla çalışmasını istediğinizi Asistan ekranında dakika cinsinden belirleyebilirsiniz. Bunun için, üst menüde yer alan Working Condition butonuna tıklayın. Açılan ekranda, sağ tarafta bulunan süre alanına örneğin 5 yazarak API’nin her 5 dakikada bir çalışmasını ayarlayın. Süreyi belirledikten sonra, sağ üstteki kaydet (save) ikonuna basarak yaptığınız ayarları kaydedin. Böylece API, belirlediğiniz periyotla otomatik olarak tetiklenecektir.