Swagger API Veri Kaynağı Ekleme Kullanıcı Kılavuzu

1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. 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.‍
3. Sources başlığı yanında bulunan + ikonuna tıklayarak yeni bir veri kaynağı ekleyin.

4. Swagger API seçeneğini belirleyin ve veri kaynağınız için bir isim girin.
5. CREATE butonuna tıklayarak işlemi tamamlayın.

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ı

• Swagger URL: Swagger API’sinin JSON dosyasının URL’sini girin.
• Servis Base URL: API’nin temel hizmet URL’sini girin.
• Description: Swagger API hakkında açıklama ekleyebilirsiniz.

C. Kimlik Doğrulama

• Authentication Type: API erişimi için kimlik doğrulama türünü belirleyin (No Auth, Bearer, Basic, API Key).‍
• Add Field: Kimlik doğrulamaya alan eklemek için kullanılır.

1. CREATE butonuna tıkladıktan sonra Connection Settings bölümünü açın.
2. Swagger URL ve Service Base URL bilgilerini girin.
3. 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.

Swagger API Authentication Türleri

1. Bearer Authentication

• Authentication Type açılır menüsünden Bearer seçin.
• Kuika, varsayılan olarak Username parametresini oluşturur.
• Custom seçeneğini kullanarak özel parametreler ekleyebilirsiniz.
• Parametre bilgilerini key-value çifti olarak girin.  
  
  • Örnek: Key: client_id, Value: your_client_id
• CREATE butonuna tıklayarak kaydedin.

2. Basic Authentication

• Authentication Type açılır menüsünden Basic seçin.
• Username ve Password bilgilerini girin.
• Custom seçeneğini kullanarak özel parametreler ekleyebilirsiniz.
• Basic Authentication için otomatik olarak oluşturulan "{BasicAuthToken}" değerini kontrol edin.
• CREATE butonuna tıklayarak kaydedin.

3. API Key Authentication

• Authentication Type açılır menüsünden API Key seçin.
• API Key kimlik doğrulama türünü kullanmak için aşağıdaki bilgileri girin:
  
  • ID key name: İstemci ID’sini temsil eden anahtar adı. 
    
    • Örnek: client_id
  • ID: İstemci ID’si.
  • Secret key name: İstemci gizli anahtarını temsil eden anahtar adı. 
    
    • Örnek: client_secret
  • Secret: İstemci gizli anahtarı.
• Custom seçeneğini kullanarak özel parametreler ekleyebilirsiniz.
• CREATE butonuna tıklayarak kaydedin.

Bu adımları takip ederek, Swagger API veri kaynağını Kuika uygulamalarınıza entegre edebilirsiniz.