OData API, Kuika platformunda kullanabileceğiniz harici veri kaynaklarından biridir. Mevcut bir OData servisini, Kuika’da geliştirdiğiniz uygulamaya veri kaynağı olarak entegre edebilirsiniz. Bu eğitim içeriğinde, OData API kullanarak uygulamanıza nasıl veri kaynağı ekleyebileceğinizi öğreneceksiniz.
OData API’yi kullanabilmek için mevcut abonelik planınızı yükseltmeniz gerekmektedir. Aboneliğinizi yükselterek, API yönetimi, OData entegrasyonu ve gelişmiş veri kaynakları gibi özelliklere erişebilirsiniz. Detaylı bilgi için Fiyatlandırma sayfasını ziyaret edebilirsiniz.
Bu eğitim içeriği aşağıdaki başlıklardan oluşur:
OData API ile uygulamanıza veri kaynağı bağlantısı ekleme
OData API modalının anatomisi
OData API bağlantı ayarlarını yapılandırma
OData API ile Uygulamanıza Veri Kaynağı Bağlantısı Ekleyin
Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
Data Sources modülünü açın. Bu modülde veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir, yeni bir veri kaynağı ekleyebilirsiniz.
Sources başlığı yanında bulunan + ikonuna tıklayarak yeni bir veri kaynağı ekleyin.
OData API seçeneğini belirleyin ve veri kaynağınız için bir isim girin.
CREATE butonuna tıklayarak işlemi tamamlayın.
OData API Modalının Anatomisi
A. Üst Menü
Başlık: Bağlantı ayarlarına isim verebileceğiniz alan.
CANCEL ve CREATE Butonları: Yapılan değişiklikleri iptal edebilir veya kaydedebilirsiniz.
B. Bağlantı Ayarları
Metadata URL: Servis metadata (şema) dosyasının URL’sini girin.
Service Base URL: OData servisinin temel URL’sini girin.
Description: Veri kaynağı hakkında açıklama ekleyebileceğiniz alan.
C. Kimlik Doğrulama
Authentication Type: API erişimi için kimlik doğrulama türünü belirleyin (No Auth, Basic, OAuth2).
Add Field: Kimlik doğrulamaya alan eklemek için kullanılır.
OData API Bağlantı Ayarlarını Yapılandırma
CREATE butonuna tıkladıktan sonra Connection Settings bölümünde:
Metadata URL ve Service Base URL bilgilerini girin.
Authentication Type açılır menüsünden kimlik doğrulama türünü seçin.
No Auth seçildiğinde ek bir işlem gerekmez.
OData API Authentication Türleri
No Authentication: Kimlik doğrulama gerektirmeyen servisler için kullanılır. Ekstra bir ayar yapmanıza gerek yoktur.
Bearer: Token tabanlı doğrulama yöntemidir. Bazı durumlarda token elde etmek için kullanıcı adı (username) kullanılabilir.
Kullanım Şekli:
Authorization: Bearer YOUR_ACCESS_TOKEN
Eğer token kullanıcı adı ve parola ile alınıyorsa, önce bir "login" işlemi yapılmalı, ardından alınan token ile işlem devam ettirilmelidir.
Basic Authentication: Kullanıcı adı ve parola ile doğrulama yapılır.
Username: Kullanıcı adı
Password: Parola
Kullanım Şekli:
Authorization: Basic base64(username:password)
İsterseniz özel parametreler ekleyebilirsiniz.
API Key Authentication: API'ye erişim sağlamak için kimlik doğrulaması amacıyla API anahtarı (key) ve bazen secret key kullanılır. Bu bilgiler genellikle API sağlayıcısı tarafından verilir ve header ya da query parametresi olarak gönderilir.
Kullanılabilecek Parametreler:
ID Key Name: API kimlik anahtarının adı (Örneğin: client_id, api_key, x-api-key)
ID: Size özel API kimlik değeri
Secret Key Name: Gizli anahtarın başlık adı (Örneğin: client_secret, secret_key)
API sağlayıcısının dökümantasyonuna göre bu değerler farklı isimlerde olabilir. Kuika’da bu değerleri doğru başlık ya da parametre olarak tanımlayarak entegrasyonu gerçekleştirebilirsiniz.
Bu adımları takip ederek, OData API veri kaynağını Kuika uygulamalarınıza kolayca entegre edebilirsiniz.
