Postman API Platformu ile JSON Veri Testi

Merhabalar! Bu yazımda günümüzde oldukça popüler olan Postman! ile ilgili deneyimlerimi ve bilgilerimi paylaşmak istedim. Şimdiden keyifli okumalar :)

Nedir bu Postman?

Postman, kullanıcıların hem basit hem de karmaşık HTTP isteklerini hızlı şekilde bir araya getirmelerini sağlar. Uzun kodlara ihtiyaç duymadan API (Application Programming Interface)’larınızı kolayca test edebileceğiniz, web, mobil gibi API ile iletişim kurulması, test edilmesi, dökümante, monitör ve sanal test ortam yaratılmasını sağlayan güçlü bir HTTP istemcisidir. Ayrıca, “Rest Client” olarak adlandırabileceğiniz bir araçtır.

Ekipçe çalışılıyorsa, bütün ekip iş birliği içerisinde paylaşımlarda bulunabilir.

Öncelerde Chrome uzantısı olarak indirebiliyorduk. Şu zamanlarda bağımsız bir uygulama olarak bilgisayarımıza indirip kullanabiliyoruz. Şuraya indirebileceğimiz, Postman’in resmi sitesini bırakıyorum.

Request/ Response mu, hö?

Request, bir sorum var cevap almak istiyorum demektir. Bunun için talepte bulunuruz.

Response ise, cevap almak istediğimiz soruna bir geri dönüştür. Yani, talebinde bulunduğunuz sorguya cevap verir.

Adım Adım Postman

İlk önce indirelim bakalım: Sayfamızı açtığımızda sol üstte Product kısmının üstüne gelelim ve Get Started Free’ye basalım. (Ücretsiz kullanımı 3 kişi dahilindedir.)

Bilgisayarımıza uygun versiyonu bulup indirelim.

Yükleme tamamlandıktan sonra, Sign in yapalım. Eğer hesabımız yoksa Create Free Account diyelim ve o şekilde devam edelim.

Ve öğrenelim

Workspaces/My Workspace bizim kendi local analizlerimizi gösterir

Workspaces içerisinde ayriyeten Team yani takım olarak yaptığımız analizleri de görebiliyoruz.

Biz My Workspace kısmına gelelim ve bir örnek ile pekiştirelim

Collections kısmından bir API koleksiyonu oluşturalım.

İsimlendirelim ve Add a request’e tıklayalım

Daha sonra uygulama yapacağımız siteyi belirleyip, senaryomuzu hazırlayalım. Ben, hepimizin bildiği ve keyifle takip ettiği twitch’i seçiyorum. Ve yanlış bir kullanıcı girişi yapıyorum :)

Site içerisinde sağ tık yapıp incele diyelim.

Daha sonra aşağıdaki görselde sarı highlight yaptığım yerlere gidelim.

İşaretlenen URL adresini ve istek yöntemine bakalım. (Bu verileri Postman içerisinde kullanacağız) kopyalayalım.

Bu görselde istek yöntemi ve URL adresini kullanacağız

Geldik Postman’e. Burada request oluşturmuştuk. Şimdi o requestimize isim verelim. Ben Login ismini verdim.

Daha sonra hangi istek yöntemi olduğunu ve URL adresini sitemizden, yukarıdaki görselde sarı highlight yaptığım yerlere bakarak, Postman’a geçirelim.

Ve save etmeyi unutmayalım :)

Sendleyelim gitsin artık :)

Body/ Pretty kısmında bir geridönüş almış olduk.

Network üzerinden Request Datamıza bakmak için, Payload kısmına gelelim. Aşağıdaki görselde sarı highlight yaptığım yeri alalım.

Ve Postman’e gelelim.

Buradan Body’e tıklayalım. raw’ı seçelim ve en sağ taraftan text olarak JSON verisini işaretleyelim.

Aşağıdaki boş alana yukarıdaki görselde Network üzerinden aldığımız Request Datamızı yazalım.

(Dikkat!! string verileri “ ” içerisine almayı unutmayalım :)).

Save edip Sendleyelim bakalım ne diyor :)

Başardık :)

Bunun gibi bir çok verinin API testlerini Postman ile yapabiliriz.

Not: İstek yöntemimiz “Get” olursa, JSON ile veri almamıza genellikle gerek yoktur.

Bir de Twitch’in kendi API’leri üzerinden gidelim

Bunu nasıl yapacağımızı şuradaki yazımda detaylı bir şekilde anlattım. Mutlaka okumanızı öneririm :)

Bu adımı da tamamladıktan sonra…

…Gelelim Enviroment Variable’a

Basitçe environments, birden fazla deployment’ı olan (development, staging, production) API’lar için oluşturulan ön tanımlı değişkenleri tutabildiğimiz yapılardır. Bir ortamda sık kullandığınız değerleri kaydetmemize yarar.

Create Environment diyelim

Oluşturduğumuz yapıya isim verelim, ben PROD ENVE adını verdim.

Ardından sitede sık kullandığımız VARIABLE ve CURRENT VALUE’lerini girelim. Save etmeyi unutmayalım…

Sağ üst köşede No Environment yazan kısma tıklayıp, oluşturduğumuz environment’i (PROD ENVE)seçelim

Artık environment’te tanımladıklarımızı JSON verimizde {{ …VARIABLE…}} iki süslü parantez içerisine VARIABLE’ını yazarak (görseldeki gibi) kullanabiliriz

RUN vakti!

Yaptığımız Collection’u komple bir RUN edelim bakalım.

Collection adımızın yanında bulunan … ya basıyoruz ve Run Collection diyoruz

Karşımıza bir Run Order çıkıyor, orada tüm request’lerimiz sıralanıyor. İsterseniz Iterations ve Delay ayarlarını değiştirebilirsiniz. Daha sonra sağ altta bulunan Run’a tıklıyoruz

İşte Run sonuçları karşımızda

Dahası mı?? Dökümantasyon!

Collection adımızın yanında bulunan … ya tıklayıp, bütün requestlerimizi View documentation’a tıklayarak dökümante edebiliriz. E yapalım :)

Dökümantasyonumuz

Export edelim

Collection adımızın yanında bulunan … ya tıklayıp, Export seçeneğini işaretleyelim

Karşımıza export penceresi gelecek, buradan önerilen (Recommended) sürümünü seçiyoruz ve Export’a basıyoruz. Ve elimize JSON dosyası olarak export edilmiş oluyor.

Bu yazımda sizlere; Postman API Platformu ile JSON Veri Testi nasıl yapılır, Postman nedir? Ne değildir :) ,Postman kurulumu, Postman kullanımı, Request/Response ilişkisi ve tanımları, Environments, Export, Dökümantasyon ve ayrıca farklı sitelerden API referansları ile kullanımı (Bunun için ayrıca şu yazımı da okumanızı öneririm:))… gibi konulara değinerek, deneyimlerimi aktarmak istedim.

Umarım faydası olur. Hepinize iyi çalışmalar dilerim :)