Postman Installation and API Testing
API (Application Programming Interface) terimi bir kısaltmadır ve “Uygulama Programlama Arayüzü” anlamına gelir. Restoran menüsü gibi düşünülebilir, Hangi menü öğelerini istediğinizi belirttiğinizde, restoranın mutfağı işi yapar ve size bazı hazır yemekler sunar.
Postman, test ediciler ve geliştiriciler için rest client aracıdır. Postman her ay 130 milyon API’ye erişmek için 6+ milyon geliştirici ve 200.000'den fazla şirket tarafından kullanılıyor. Postman ile API’leri test edebilir, RESTful durumunda geliştirilen uygulamayı test ederken bir müşteri olarak hareket edebilir, bir ortam oluşturabilir, test senaryoları yazabilir, API’ları paylaşabilirsiniz, vb aksiyonlar almanızı sağlar. Bir diğer güzel api aracı da google’ın apigee ona sonraki yazılarda entegrasyon için değinebiliriz.
Postman Chrome eklentisi olarak çalışabildiği gibi MacOS ve Windows için de desktop uygulamaları mevcuttur. Tavsiye edileni native app olarak kurulmasıdır, bu yazıda windows üzerinde kurulumunu yapacağız. Google chrome app duyurusu;
https://blog.chromium.org/2016/08/from-chrome-apps-to-web.html
İlgili adresten dosya indirilir: https://www.getpostman.com/downloads/
Postman-win64–6.7.4-Setup.exe dosyası çalıştırılır
Kurulum tamamlandıktan sonra kullanıcı hesabı oluşturma ekranı çıkıyor,
Bu adımı bitirden sonra uygulama ekranı karşılaşıyoruz.
Eğer farklı paket yüklediyseniz veya mevcut sürümün üstüne güncelleme geldiyse; sağ üst bölümden güncelleme yapabilirsiniz.
Postman API isteklerini göndermeyi kolaylaştırır. API’lerinizi bir komut satırı veya terminal aracılığıyla test etmek yerine, öğrenmesi kolay ve ödüllendiren sezgisel bir grafik arayüzü ile yapmamızı sağlar.
En yaygın yöntemler GET, POST, PUT ve DELETE’dir. Yöntemlerin isimleri ; Örneğin GET, bir sunucudan veri almanıza olanak sağlar. POST, sunucudaki mevcut bir dosyaya veya kaynağa veri eklemenizi sağlar. PUT, sunucudaki mevcut bir dosyayı veya kaynağı değiştirmenize olanak sağlar. DELETE de bir sunucudan veri silmenizi sağlar.
Request ve response dan kısaca bahsedip api testi yapalım.
Postman’ı başlattığınızda “Create New” ekranı varsayılan olarak görüntülenir. Ekranın altında, Postacı’yı her açışınızda “Create New” ekranının görüntülenmesini isteyip istemediğinizi belirtmek için “Show this window at launch” i seçebilirsiniz.
“Create New” ekranında, “Request” e tıklayın.
Çalışma Alanlarında, hızlı bir şekilde her türlü HTTP isteğini oluşturabilirsiniz. Bir HTTP isteğinin dört bölümü URL, method, headers ve body dir. Postman size bu parçaların her biri ile çalışmak için araçlar verir.
URL
URL giriş alanına istek URL’sini girdiğinizde, daha önce kullanılan URL’ler otomatik tamamlama açılır menüsünü gösterir.
URL parametreleri için veri düzenleyiciyi açmak için Params düğmesini tıklayın. Anahtar-değer çiftleri eklediğinizde, Postman yukarıdaki sorgu dizesindeki her şeyi birleştirir. URL’nizde zaten parametreler varsa, örneğin, başka bir kaynaktan bir URL yapıştırıyorsanız postman URL’yi otomatik olarak çiftlere böler.
Headers
Başlıklar (headers) sekmesini tıkladığınızda başlıklar anahtar / değer düzenleyicisi gösterilir. Herhangi bir dizeyi başlık adı olarak ayarlayabilirsiniz. Otomatik tamamlama açılır alanı, alanları girdiğiniz sırada genel HTTP başlıklarının önerilerini sunar. “Content-Type” başlığı için değerler otomatik tamamlama açılır menüsünde de bulunur.
Cookies
Her bir alanla ilişkili çerezleri düzenlemek için çerez yöneticisini kullanarak, çerezleri yerel uygulamalarda yönetebilirsiniz. Modal’i açmak için, Send düğmesinin altındaki Cookies bağlantısını tıklayın. Daha fazla bilgi için, bkz. Çerezleri yönetme. Managing cookies.
Method
İstek yöntemini değiştirmek için kontrol açılır menüsünü kullanın. İstek gövdesi editörü alanı, yöntemin kendisine bağlı bir gövdesi olup olmamasına bağlı olarak değişir.
Request Body
İstekleri oluştururken, istek editörü ile sık sık çalışacağız. Postman hemen hemen her türlü HTTP isteğini göndermeni sağlar. Vücut editörü 4 alana bölünmüştür ve vücut tipine bağlı olarak farklı kontrollere sahiptir.
Responses
Postman response viewer, API yanıtlarının doğruluğunu sağlamaya yardımcı olur. Bir API yanıtı gövde, başlıklar ve durum kodundan oluşur. Postacı vücut ve başlıkları farklı sekmelerde düzenler. API kodunun durum kodu ve tamamlanma süresi sekmelerin yanında görülebilir.
Postman Body sekmesi size yanıtı hızla anlamanıza yardımcı olacak birkaç araç sunar. Vücudu üç görünümden birinde görüntüleyebilirsiniz — pretty, raw ve preview.
Pretty mod, JSON veya XML yanıtlarını biçimlendirir, böylece görüntülenmesi daha kolaydır. Pretty modun içindeki bağlantılar vurgulanır ve üzerlerine tıklamak, Postman’a GET isteğini link URL’si ile yükleyebilir. Büyük yanıtlarda gezinmek için, yanıtın büyük bölümlerini daraltmak için soldaki aşağıyı gösteren üçgenleri (▼) tıklayın.
Postacının gövdeyi otomatik olarak biçimlendirmesi için, uygun İçerik Tipi başlığının döndürüldüğünden emin olun. Değilse, biçimlendirmeyi JSON veya XML ile zorlayabilirsiniz. JSON biçimlendirmesini AYARLAR modundaki Genel sekmesi altında zorlayabilirsiniz. Böyle yaparak. “Dil algılama” açılır menüsünden “JSON” işlevini seçiniz.
Headers
Headers, Headers sekmesinin altında anahtar / değer çiftleri olarak görüntülenir. Başlık adının üzerine gelindiğinde, size HTTP spesifikasyonuna göre başlığın açıklaması verebilir. Bir HEAD isteği gönderiyorsanız, Postman varsayılan olarak başlıklar sekmesini gösterecektir.
Response time
Postman, yanıtın sunucudan gelmesi için geçen süreyi otomatik olarak hesaplar. Bu, performans için bazı ön testler için kullanışlıdır.
Yazı virustotal entegrasyonu ile devam edecektir…
Kaynaklar
