Postman Nedir?

Postman, Chrome uzantısı olarak kullanabileceğimiz veya direct indirip bilgisayarımıza yükleyebileceğimiz bir uygulamadır. Rest Client olarak da tanımlanabilir.

API(Application Programming Interface) farklı uygulama yazılımlarının birbirleri ile etkileşim sağlamasına olanak sağlar. Client(Android) ve Backend(java) yazılımlarının Restfull Api ile iletişim kurması buna örnek verilebilir.

Postman sayesinde uzun uzun kodlar yazmak yerine API’lerimizi kolayca test edebiliriz. Birçok özelliği sayesinde kolay bir şekilde istek hazırlayıp gelen cevap değerlerini kullanabiliriz

POST-GET-PUT-DELETE

Yukarıdaki resimin sağ tarafında kırmızı ile işaretlenen yerde istek metod türlerimiz bulunmakta

En çok kullanılan GET, POST, PUT, DELETE metodlarını ne zaman kullanmalıyız aşağıda açıklıyor olucam.

Note: CRUD operasyonları Create, Read, Update, Delete olarak adlandırılıyor

1) GET: Sunucudan sadece veri çekmek(okuma) istiyorsak yani veri üzerinde herhangi bir değişiklik(ekleme, slime, modifiye) yapılmayacaksa GET metodunu kullanmamız tavsiye ediliyor.

CRUD operasyonlarından Read’e karşılık geldiğini söyleyebiliriz.

Ör: GET /students kullandığımızda bize öğrenciler listesini dönmesi.

2) POST: Server Api’e body kısmını doldurarak ve veri üzerinde değişiklik yapmak istediğimizde kullanabiliriz

Değişilik yapmak ile kastedilen CRUD operasyonlarından Create ve Update kısımlarını kapsar.

Ör: Post /createUser ile body kısmına kullanıcı bilgileri girip veritabanında bir kullanıcı oluşturulması istenmesi

3) PUT: Post isteğinin özelliklerine sahiptir. Yani CRUD operasyonlarından Create ve Update operasyonlarını yapmak istediğimizde kullanıyoruz.

Post’dan ayrılan tarafı Put isteğinin idempotent ve not cacheable olarak tanımlanması

4) DELETE: CRUD operasyonlarından Delete’e karşılık gelir. Bir veriyi silmek istediğimizde kullanılması tavsiye ediliyor

PARAMS-HEADER-BODY-PATH-SEND

Yukarıdaki resimde Postman body kısmında bulunan numaralandırılmış olan yerlerden bahsedicem

Bir istek hazırladığımız zaman genellikle aktif olarak bu 5 alan kullanılıyor

1 numara ile gösterilen yer Api Url girdiğimiz yer.

2 numara ile gösterilen yer Params değerlerini tanımladığımız alan

3 numara ile gösterilen yer Headers değerlerini tanımladığımız alan

4 numara ile gösterilen yer Body kısmını doldurucağımız alan raw, binary gibi seçenekler mevcut

5 numara ile gösterilen yer isteğimizi hazırladığımızda Send’e basarak isteğimizi atabiliyoruz

HISTORY

Postman’nin sol tarafında bulunan History sekmesi önceden kullandığımız istekleri gün gün tutuyor

Herhangi birine tıklayınca yeni sekmede tıklanılan istek açılıyor

COLLECTİON

Collection bize birden fazla isteği grup halinde kaydetmemizi, gerektiğinde başkalarıyla paylaşmamızı sağlıyor. Bu sayede bir projede çalışırken hali hazırda kullandığımız istekleri düzenli bir şekilde elimizin altında tutmamızı sağlıyor.

Öncelikle aşağıdaki gibi New Collection sekmesinden yeni bir Collection oluşturuyoruz.

Collection ismini verip Create demeniz yeterli

Yeni oluşturduğumuz Deneme Collection’a eklemek üzere bir istek hazırlıyoruz aşağıdaki resim gibi ve Save buton’nun yanındaki ok’a tıklıp Save As… diyoruz.

Save as ekranından istek ismini ve gerekiyorsa açıklamasını girip hangi Collection’a kaydedilmesi gerektiğini seçiyoruz. Sonrasında Deneme Collection’nın altında eklediğimiz isteği görebiliriz.

Ek olarak Deneme Collection’nın altına add folder diyerek GET, POST, DELETE gibi dosyalar açıp oluşturduğumuz istekleri bu dosya düzenine göre yerleştirmek faydalı olacaktır.

Environment

Environment tanımlamadaki amacımız sabit değişkenleri belirlemek.

Environment tanımlamak için 2 ile gösterilen sekmeyi tıklayıp Manage Environments’a geçiyoruz.

Add tıklıyoruz ve aşağıdaki örnekteki gibi environment’larımızı tanımlıyoruz.

Ör: Bir environment tanımladım ismi: Localhost, variable: url, value: http://localhost:8080

Bir environment daha tanımladım ismi: Prod, variable: url, value: http:// 159.159.59.159

Artık Api url kısmında {{url}}/users dediğimde ve 1 numara ile gösterilen yerden Localhost seçtiğimde

{{url}}/users, http://localhost:8080/users olarak davranıyor.

Benzer şekilde Prod seçersem http:// 159.159.59.159/users olarak algılanıyor

Code

Yukarıdaki resimde görüldüğü üzere Postman sağ tarafında Code diye bir seçenek var.

Bu seçenek bize hazırladığımız isteğin koda çevrilmesini sağlıyor.

Code buton’a bastığımızda bizi yukarıdaki resim karşılıyor.

Resmin sol üstte kırmızıya alınan yerden kodlama yapacağımız dili seçebiliyoruz.

Örnekte Java dili OkHttp kütüphanesi kullanılarak, bizim hazırladığımız isteğe karşılık gelen kodu sağ tarafta görebiliyoruz.

Bu özellik bize Postman’de istek hazırladım çalıştırdım ama kod tarafında nasıl yapmalıyım sorusunun cevabını veriyor.

Bu yazıda sizelere Postman hakkında genel bilgi verdim. Postman’nin çok kullanılan özelliklerinden ve Collection-Code-Environment gibi kullanımı oldukça faydalı olan konulardan bahsettim. Bu yazının Postman hakkında size faydalı olacağını umuyorum.