Merhabalar!
Ayrıntılı bir postman serisi hazırlamaya karar verdim ve bu seride öğrendiğim her şeyi ayrıntıları ile aktaracağım. Bu adresten Postman’e üye olup ardından bilgisayarınıza indirebilirsiniz. Kurulum işlemleri tamamsa başlayalım.
Bu uygulamamızda, Restful-booker isimli web sitesinden ve api dokümantasyonundan faydalanacağız. Bu site bize bir otel uygulaması üzerinden yapabileceğimiz işlemleri göstermekte.
ÖNEMLİ NOT: Restful-booker’ın çalışma mantığına yüzünden web sitesinde yaptığımız işlemler belirli bir süre için geçerli, oluşturduğumuz rezervasyon ID’leri veya token’lar bir süre sonra geçerliliğini yitiriyor. Eğer işlemleri yaparken hata alıyorsanız yeniden token oluşturmayı deneyin veya işlem yaptığınız ID’nin bir rezervasyona kayıtlı olup olmadığını kontrol edin.
Senaryomuza göre adımlar şu şekilde ilerleyecek:
1- Token oluşturacağız. [POST]
2- Tüm rezervasyonları görüntüleyeceğiz. [GET]
3- Seçtiğimiz bir rezervasyonu görüntüleyeceğiz. [GET]
4- Bir rezervasyon oluşturacağız. [POST]
5- Oluşturulan rezervasyonda değişiklik yapacağız. [PUT]
6- Oluşturulan rezervasyonda güncelleme yapacağız. [PATCH]
7- Oluşturulan rezervasyonu sileceğiz. [DELETE]
Görüldüğü üzere, senaryolar tüm HTTP Metotlarını içermekte.
Öyleyse başlayalım.
1- Token Oluşturma
Restful-booker’ın dokümantasyonu token oluşturabilmemiz için bizden zorunlu olarak “username” ve “password” istemekte. Body içerisinde bu alanları doldurup dokümantasyonda verilen URL ile istek yapıyoruz.
Görselde de görüldüğü gibi, gerekli alanları doldurup gönderdik ve sonucunda Status 200 alarak bir token oluşturduk. Bu token ile ileride silme ve güncelleme işlemleri yapacağız.
2- Tüm Rezervasyonları Görüntüleme
Restful-booker’ın dokümantasyonu tüm rezervasyonları görüntüleyebilmemiz için bir adet URL içeriyor. Bu URL ile işlemimizi yapacağız. Bu işlem için GET metodu kullanılması gerektiğini unutmuyoruz.
Görselde görüldüğü gibi, yapılmış tüm rezervasyonlara ait ID’ler listelenmiş durumda. Bir sonraki işlemde herhangi bir ID numarası üzerinden kayıtlı olan rezervasyona ulaşmayı deneyeceğiz.
3- Seçtiğimiz Bir Rezervasyonu Görüntüleme
Bir önceki işlemde tüm rezervasyonlara ait ID’leri bulmuştuk, buradan istediğinizi seçip görüntülemekte özgürüz. Karışıklık olmaması adına ID’si 1 olan rezervasyona bakacağız. İşlemi nasıl yapacağımızı her zamanki gibi dokümantasyondan öğreneceğiz.
Görselde görüldüğü gibi işlemi yaptık ve 1 ID numaralı rezervasyonun Susan Jackson adına kayıtlı olduğunu gördük. Siz de isterseniz bir önceki işlemden gelen ID numaraları ile farklı sorgular yapabilirsiniz.
4- Bir Rezervasyon Oluşturma
Bu işlemde, Postman aracılığıyla bir rezervasyon oluşturacağız. Restful-booker’ın dokümantasyonunda bu rezervasyonu oluşturabilmemiz için bizden bazı zorunlu alanlar istemekte. Body içerisinde bu alanları doldurup rezervasyonu oluşturacağız. Yeni oluşturduğumuz rezervasyona ait ID’yi alıp daha sonraki işlemlerimizde kullanacağız.
Post metodunu kullanarak bir rezervasyon oluşturduk ve sonrasında bize 2416 numaralı ID atanmış oldu. Sıradaki işlemlerde bu ID’yi kullanacağız.
5- Oluşturulan Rezervasyonda Değişiklik Yapma
Bir önceki işlemde kendi ismimizle oluşturduğumuz rezervasyonda değişiklik yapmayı deneyeceğiz. Her zamanki gibi, dokümantasyona göz atıyoruz ve işlemlerimizi sıralıyoruz.
Görselde gözüktüğü gibi, Kaan Gedikli adına olan rezervasyonu Osman Ateş adına değiştirdik. 2416 ID’li rezervasyon artık bizim adımıza kayıtlı değil. Bu işlemi yaparken en başta oluşturduğumuz token’ı Headers kısmına yazmayı unutmuyoruz.
6- Oluşturulan Rezervasyonda Güncelleme Yapma
Bu sefer, PATCH metodu ile bir güncelleme yapacağız. Bu işlem için de token kullanacağız. Dokümantasyonda gerekli yerleri nasıl doldurmamız gerektiğine baktıktan sonra işleme geçiyoruz.
PATCH metodu ile, Osman Ateş adına kayıtlı olan rezervasyonu tekrardan Kaan Gedikli adına kayıtlı olacak şekilde değiştirdik.
7- Rezervasyonu Silme
Son işlemimizde DELETE metodunu kullanacağız. Dokümantasyona göz atıp gerekli alanları dolduruyoruz. Token tanımlamayı burada da unutmuyoruz.
945 ID’li rezervasyonu 201 Created dönüşü ile silmeyi başardık. Rezervasyonları listelediğimiz Request ile kontrolünü sağladık ve 945 ID’si ile sorgulama yaptığımızda Not Found dönüşünü aldık.
7 işlemde hem metotları tekrarlamış olduk, hem de Postman’e giriş niteliğinde bir uygulama yaptık. Bu uygulamada, dokümantasyon okumanın önemine ufak da olsa bir vurgu yapmayı da ihmal etmedik.
Postman hakkında daha fazla içerik önümüzdeki günlerde web sitemde olacak, okduğunuz için teşekkürler, daha sonra görüşmek üzere!
Bir yanıt yazın