Test Console

Postman veya SOAP UI gibi harici araçlar kullanmadan SOAP ve REST API’leri test edebilirsiniz, test senaryolarını kaydedebilirsiniz, teyit (assertion) tanımlayabilirsiniz, istek ve yanıtları inceleyebilirsiniz ve ortam değişkenlerini yönetebilirsiniz.

Test Konsolu

Test Konsolu üç ana bölümden oluşur:

İstek

İstek hazırlama işlemlerini yönetir

Yanıt

Yanıta ait sonuç işlemlerini yönetir

Test Kayıtları

Test geçmişi ve grup olarak kaydedilmiş testleri görüntüler

​

İstek

​

İstek Adresini Oluşturma

İstek adresi oluşturmanın iki yolu bulunur:

• Test edilmek istenen endpoint manuel olarak yazılabilir
• Test Helper arayüzünden Apinizer üzerindeki bir API Proxy test edilebilir veya API tanım dosyası üzerinden istek adresi oluşturulabilir

​

Test Helper ile İstek Adresini Oluşturma

Aşağıdaki görselde seçili butona tıklandığında Test Helper dialogu açılır.

Test Helper Butonu

Test Helper Ayarları

Test Helper konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan	Açıklama
İstek Tipi	Proxy, Proxy Group, Swagger, OpenApi, WADL, WSDL seçeneklerinden biri seçilerek test edilecek API tipi belirlenir. Bu tipler: Proxy, Proxy Group Bu tipler, Apinizer üzerinde seçili projenizde bulunan API Proxy’ler test edilmek istendiğinde seçilir. Ayrıca, seçili API Proxy’nin deploy edildiği ortamlardan test edilir. Swagger, OpenApi, WADL, WSDL Bu tipler, API tanım dosyası üzerinden test yapılmak istendiğinde seçilir.
Proxy Grup Listesi	Aynı proje içindeki test edilebilecek API Proxy grupları listelenir.
Proxy Listesi	Aynı proje içindeki test edilebilecek API Proxy’ler listelenir. Proxy’nin test edilebilmesi için deploy edilmiş olması gerekir.
Servis URL	Test edilecek API’nin servis URL’idir. URL vasıtasıyla parse işlemi yapılır ve API’nin uç noktaları oluşturulur.
Uç Noktalar	API’de bulunan uç noktalar arasından test edilecek uç nokta seçilir.
Ortam Listesi	Proxy’nin test edileceği ortam seçilir.

Oluşturulan uç noktanın eğer varsa parametre listesi ve örnek istek gövdesi (request body) de Apinizer tarafından oluşturulmaktadır.

​

Sorgu Parametresi Ekleme

Parametreler tabından isteğin sorgu parametreleri yönetilir. Düzenlenen her değer URL bilgisi üzerinde otomatik olarak güncellenir.

Sorgu Parametresi Ekleme

​

Başlık Ekleme

Başlıklar tabından istek başlıkları yönetilir.

Başlık Ekleme

​

Gövde Ekleme

İsteğin gövdesine eklenecek veri iki farklı şekilde oluşturulabilir: raw, x-www-form-urlencoded

Gövde Ekleme

​

Format XML

İsteğin gövdesine eklenecek veri ile Format XML işlemi yapılabilir.

Format XML

​

Format JSON

İsteğin gövdesine eklenecek veri ile Format JSON işlemi yapılabilir.

Format JSON

​

WS Security İmzala

İsteğin gövdesine eklenecek veri raw olarak seçildiğinde WS Security İmzala işlemi yapılabilir.

WS Security İmzala

WS Security İmzalama tuşuna basıldığında aşağıdaki konfigürasyonla test konsolundaki veri imzalanır.

WS Security İmzala Ayarları

WS Security İmzala konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan	Açıklama
Private Key	İmzalama için kullanılacak Private Key değerinin PKCS#8 PEM formatındaki metinsel halidir.
Sertifika	İmzalama için kullanılacak sertifikanın PKCS#8 PEM formatındaki metinsel halidir.
Signature Algorithm	İmzalama algoritması bilgisidir.
Signature Canonicalization	İmza kanonikleştirme bilgisidir.
Digest Algorithm	İmzada kullanılacak digest algoritmasıdır.
Key Identifier Type	İmza anahtarının mesajın neresine nasıl yerleştirileceği bilgisidir.
Use Single Certificate	İmzalamanın tek sertifika ile mi yapılacağı bilgisidir.
Must Understand	WS-Security başlığında “Must Understand” değerinin ne olması gerektiğini belirtir.
WS Encryption Part	Verinin nerelerinin imzalanacağı bilgisidir. Birden fazla değer girilebilir. İmzalanacak XML elemanı adı, XML elemanının namespace bilgisi ve Element olarak mı İçerik olarak mı imzalanacağı bilgisidir.

​

JSON İmzala

İsteğin gövdesine eklenecek veri raw olarak seçildiğinde JSON İmzala işlemi yapılabilir.

JSON İmzala

JSON imzalama tuşuna basıldığında aşağıdaki konfigürasyonla test konsolundaki veri imzalanır.

JSON İmzala Ayarları

JSON imzala konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan	Açıklama
Algoritma	İmzalama yapılacak algoritma bilgisidir
Private Key	İmzalama için kullanılacak Private Key değerinin PKCS#8 PEM veya JWK formatındaki metinsel halidir.
Issue Time Ekle	Oluşturulacak imzanın içine oluşma zamanı eklenecekse bu seçenek aktifleştirilmelidir.
Expiration Time Ekle	Oluşturulacak imzanın içine tükenme zamanı eklenecekse bu seçenek aktifleştirilmelidir.
Expiration Time Value	İmzanın ne kadar süre geçerli olacağı bilgisidir
Expiration Time Unit	İmzanın geçerli olma süresinin zaman birimidir.
JWT Headers	İmzalanacak verinin başlık kısmına ekstra başlık bilgisi eklenmek istenirse bu alana JSON formatında eklenebilir.
Payload	İmzalanacak verinin gövde kısmına ekstra bilgi eklenmek istenirse bu alana JSON formatında eklenebilir.

​

Teyit Oluşturma

Teyit tabı, istek gönderirken dönecek olan yanıtla ilgili zaman aşımı, HTTP durum kodu, gövde, JsonPath/XPath ile gövdedeki değeri sorgulayarak beklenen değerlerle doğrulanmasına izin verir.

Teyit Oluşturma

Teyit konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan	Açıklama
Zaman Aşımı’nı Teyit İçin Kullan	Eğer aktifleştirilirse, isteğin zaman aşımı değeri kullanarak doğrulama yapılır.
Sonuç Durum Kodu	Durum kodu bazında doğrulama yapmak için aktifleştirilir.
Beklenen Durum Kodu	Beklenen durum kodunun değeri yazılır.
Sonuç Gövdesi	Yanıtın gövdesini doğrulamak için aktifleştirilir.
Beklenen Sonuç Gövdesi	Beklenen yanıt gövdesinin değeri yazılır.
XPath Sonucu	Yanıtın gövdesinin içindeki bir değeri doğrulamak için aktifleştirilir. Yanıtın gövde değerine ait veri tipi XML formatında olmalıdır.
Beklenen XPath	Yanıt gövdesinde doğrulanmak istenen değeri tutan anahtar bilgisi için XPath sorgusu yazılır.
Beklenen XPath Sonucu	Yanıt gövdesinde doğrulanmak istenen XPath bilgisininde beklenen sonuç yazılır.
JsonPath Sonucu	Yanıtın gövdesinin içindeki bir değeri doğrulamak için aktifleştirilir. Yanıtın gövde değerine ait veri tipi JSON formatında olmalıdır.
Beklenen JsonPath	Yanıt gövdesinde doğrulanmak istenen değeri tutan anahtar bilgisi için JsonPath sorgusu yazılır.
Beklenen JsonPath Sonucu	Yanıt gövdesinde doğrulanmak istenen JsonPath bilgisininde beklenen sonuç yazılır.

​

Ayarlar

Ayarlar sekmesinde zaman aşımı ve güvenli bağlantı (SSL/TLS/mTLS) ayarları yönetilir.

Güvenli Bağlantı Ayarları

​

Üst alanlar

Alan	Açıklama
Connection Timeout	Bağlantı kurulurken beklenecek azami süre (saniye). Alanın altındaki açıklama: bağlantı için beklenecek en fazla süre.
Skip SSL Verification	Açıkken sunucu sertifikası doğrulanmaz; self-signed sertifika kullanan ortamlar için uygundur. Etkin olduğunda TrustStore, Sertifika ve KeyStore ile ilgili genişletilebilir paneller gizlenir.

​

Genişletilebilir bölümler

Aşağıdaki başlıkların sağındaki + ile paneller açılır; TrustStore, PEM sertifikası, istemci KeyStore ve protokol/hostname doğrulaması bu paneller üzerinden yapılandırılır:

• TrustStore (JKS/PKCS12)
• Certificate (PEM)
• KeyStore (Client Certificate) — Hedef sunucu mTLS istediğinde istemci sertifikası
• Protocol & Verification Settings — Desteklenen TLS sürümleri ve hostname doğrulayıcı

​

TrustStore (JKS/PKCS12)

Sunucu sertifikasını doğrulamak için kullanılır:

Seçenek	Açıklama
Var Olanı Seç	Mevcut KeyStore havuzundan bir TrustStore seçilir. Yeni oluşturmak için artı (+) butonuna tıklanır.
TrustStore Yükle	.jks, .p12 veya .pfx dosyası yüklenir. Parola girilir; Dene ile parola denenebilir.

​

Sertifika (PEM)

PEM formatında sertifika kullanımı:

Seçenek	Açıklama
Var Olanı Seç	Mevcut sertifika havuzundan bir sertifika seçilir. Yeni oluşturmak için artı (+) butonuna tıklanır.
PEM Sertifika Yükle	.pem, .crt veya .cer dosyası yüklenir.

​

KeyStore (İstemci Sertifikası)

Hedef sunucu mTLS doğrulaması istiyorsa istemci sertifikası gönderimi:

Seçenek	Açıklama
Var Olanı Seç	Mevcut KeyStore havuzundan bir KeyStore seçilir. Yeni oluşturmak için artı (+) butonuna tıklanır.
KeyStore Yükle	.jks, .p12 veya .pfx dosyası yüklenir. Parola girilir; Dene ile parola denenebilir.

​

Protokol ve Doğrulama Ayarları

Alan	Açıklama
Desteklenen Protokoller	TLS/SSL protokol sürümleri seçilir (TLSv1.3, TLSv1.2 vb.).
Hostname Doğrulayıcı	Sunucu hostname doğrulama yöntemi seçilir (Default, Strict, Browser Compat, Noop).

Yüklenen TrustStore, Sertifika veya KeyStore dosyasını daha sonra diğer ekranlarda kullanmak için KeyStore Havuzuna Ekle veya Sertifika Havuzuna Ekle seçeneğini işaretleyip bir isim verebilirsiniz.

KeyStore ve TrustStore havuzu hakkında detaylı bilgi için Key Stores sayfasına bakınız.

​

Code Snippet

Code Snippet tabında, cURL üzerinden isteği göndermek için gerekli kodun üretilmesi sağlanır.

Code Snippet

​

Yeni Test Oluşturma

Test işlemi yapıldıktan sonra yeni bir test yapılmak istiyorsa aşağıdaki görselde işaretli butona tıklayarak, test alanlarının bilgileri yenilenebilir.

Yeni Test Oluşturma

​

Yanıt

​

Yanıt Gövdesi

Yanıtın gövdesi bu kısımda gösterilir.

Yanıt Gövdesi

Yanıt gövdesi verisi ile Format XML, Format JSON işlemi yapılabilir.

​

İstek Yanıtı Başlıkları

Yanıtın başlıkları bu kısımda gösterilir.

İstek Yanıtı Başlıkları

​

Teyit Sonuçları

İsteğe eklenen teyitlerin başarılı olup olmadığına ait sonuçlar bu tabda gösterilir.

Teyit Sonuçları

​

Yanıt Logları

Yanıt bilgisinin logu bu kısımda görülür.

Yanıt Logları

​

Geçmiş

Test Konsolu’nda test edilen her isteğin geçmişi saklanır. Testin geçmişi, test edildikleri günlere göre kategorilere ayrılır.

Testin loguna ait linke tıklandığında, istek tekrar test edilebilir.

Test Geçmişi

​

Test Geçmişini Silme İşlemleri

• Tüm geçmiş bilgilerini silmek için Hepsini Sil (Clear All) linkine tıklanır
• Gün bazlı geçmişi silmek için ilgili gün bilgisinin detay menüsünden silinir
• Sadece geçmişi silmek için ilgili geçmiş bilgisinin detay menüsünden silinir

​

Koleksiyon

Koleksiyon, testlerin tekrar kullanılabilmesi için test kayıtlarının bir grup çatısı altında yapılandırılarak oluşturulmasıdır.

Her koleksiyon içinde birden fazla koleksiyon bulunabilir.

​

Testi Bir Koleksiyona Kaydetme

Testinizi tamamladıktan sonra kayıt etmek için görseldeki işaretlenen Kaydet butonuna tıklanır.

Testi Koleksiyona Kaydetme

Sonrasında açılan **Koleksiyon Listesi ** adlı dialogda testin atanacağı koleksiyonun linkine tıklanır.

Apinizer başlangıç için ‘Default Collection’ adlı bir koleksiyonu oluşturmaktadır.

Koleksiyonunu seçtikten sonra teste bir ad vererek kaydedilir. Varsayılan test kaydının ismi, test ettiğiniz endpoint URL bilgisi olarak belirlenmiştir.

Koleksiyon Listesi

​

Koleksiyon Bazlı İşlemler

Koleksiyon üzerinde yapılabilecek işlemlere, aşağıdaki görseldeki koleksiyonun detay menüsü üzerinden yapılır.

Koleksiyon Bazlı İşlemler

Yeniden Adlandır: İlgili koleksiyonun adını değiştirmek için kullanılır. Tıklandığında çıkan ekrana yeni ad verilir ve kaydedilir.

Yeni Koleksiyon Ekle: İlgili koleksiyonun içine yeni bir koleksiyon eklenmek için kullanılır.

Koleksiyonu Sil: İlgili koleksiyonu silmek için kullanılır. Eğer bir koleksiyonu silinirse, ilgili koleksiyona bağlı bütün kayıtlar silinecektir.

​

Kayıt Bazlı İşlemler

Kayıt üzerinde yapılabilecek birçok işleme, aşağıdaki görseldeki detay menüsü üzerinden ulaşılır.

Kayıt Bazlı İşlemler

Rename: İlgili testin adını değiştirmek için kullanılır. Tıklandığında çıkan ekrana yeni ad verilir ve kaydedilir.

Duplicate: İlgili testin bir kopyasının oluşturulması için kullanılır.

Create Monitor: İlgili testi kullanarak bir Çalışma Süresi Monitörü oluşturmak için kullanılır. Detaylı bilgi almak için Uptime Monitor sayfasına tıklayınız.

Delete Test: İlgili testi silmek için kullanılır.

Farklı Kaydetme: Kaydedilmiş bir testi başka bir koleksiyona kaydedebilmek için görselde işaretlenen butona tıklanır.

Farklı Kaydetme