Postman Nedir?
Postman, API testleri yapma, API belgelerini oluşturma ve paylaşma, otomasyon ve işbirliği için kullanılan bir geliştirici aracıdır. Hem masaüstü uygulaması hem de web sürümü bulunur ve API geliştirme süreçlerini hızlandırır.
- API Testleri: API’lerinizi test etmek ve hataları hızlıca bulmak için Postman kullanabilirsiniz.
- Dokümantasyon: API belgelerini oluşturmanızı ve paylaşmanızı sağlar.
- İşbirliği: Ekip üyeleri arasında API test koleksiyonları ve belgeleri paylaşabilir ve işbirliği yapabilirsiniz.
Postman Kurulumu:
- Postman’ı resmi web sitesinden indirin ve bilgisayarınıza yükleyin.
- Postman hesabı oluşturun veya giriş yapın.
Postman Temel Kavramlar:
- Workspace (Çalışma Alanı): Projelerinizi ve koleksiyonlarınızı organize etmek için kullanabileceğiniz bir alan.
- Collection (Koleksiyon): API testlerini ve isteklerini gruplandırmak için kullanılır.
- Request (İstek): Bir API servisine gönderilecek isteği temsil eder.
- Environment (Çevre): Ortam değişkenleri, farklı ortamlar arasında geçiş yapmanıza ve değişkenleri kullanmanıza olanak tanır.
Postman Kullanımı:
- Çalışma Alanı (Workspace) Oluşturma: İlk olarak, Postman’da çalışma alanı oluşturarak projelerinizi ve koleksiyonlarınızı düzenlemeye başlayın. Çalışma alanları, projelerinizi gruplandırmak ve düzenlemek için kullanılır.
- Koleksiyon (Collection) Oluşturma: Çalışma alanınız içinde yeni bir koleksiyon oluşturun. Koleksiyonlar, API testlerini ve isteklerini gruplandırmak için kullanılır. Koleksiyonunuzu adlandırın ve açıklama ekleyebilirsiniz.
- İstek (Request) Ekleme: Koleksiyonunuzun içine API isteği eklemek için şu adımları izleyebilirsiniz:
- Koleksiyonunuzu seçin.
- Sağ üst köşede “Add Request” veya “Request” düğmesine tıklayın.
- İsteğinizi adlandırın ve gerekli ayrıntıları girin: URL, HTTP yöntemi (GET, POST, PUT, vb.), başlıklar, parametreler ve gövde.
- İstekleri Düzenleme: Eklediğiniz istekleri düzenlemek için isteği seçin ve açık olan “Params,” “Headers,” ve “Body” sekmesini kullanarak gerekli değişiklikleri yapın. Örneğin, JSON veya XML verilerini gövdeye eklemek için “Body” sekmesini kullanabilirsiniz.
- İstekleri Çalıştırma: İstekleri çalıştırmak için aşağıdaki adımları takip edin:
- İstek listenizde isteği seçin.
- Sağ üst köşede bulunan “Send” düğmesine tıklayın.
- İstek gönderildiğinde, yanıtı “Response” sekmesinde görebilirsiniz.
- Ortam Değişkenleri Kullanma: Postman’da ortam değişkenleri oluşturarak farklı ortaml arasında geçiş yapabilirsiniz. Örneğin, geliştirme, test ve üretim ortamları için farklı URL’leri saklamak için ortam değişkenleri kullanabilirsiniz. Ortam değişkenlerini “Manage Environments” seçeneği altından yönetebilirsiniz.
- Koleksiyonları Paylaşma: Koleksiyonlarınızı ekip üyeleriyle paylaşabilirsiniz. Koleksiyonunuzu seçin, sağ üst köşede bulunan “Share” veya “Export” düğmesini kullanarak paylaşma seçeneklerini göreceksiniz. Koleksiyonları Postman web hizmeti aracılığıyla da paylaşabilirsiniz.
- Otomasyon: Postman, API testlerini otomatikleştirmek için iki ana yöntem sunar:
- Postman Runner: Koleksiyonlarınızı toplu olarak çalıştırmak için kullanabilirsiniz. Çalıştırmak istediğiniz koleksiyonu seçin ve “Runner” seçeneğini kullanarak testlerinizi otomatikleştirin.
- Newman: Command-line aracıdır ve Postman koleksiyonlarını komut satırından çalıştırmanızı sağlar. Bu, sürekli entegrasyon (CI) ve sürekli dağıtım (CD) işlemleri için idealdir.
Postman’ın Avantajları:
- Kolay kullanım: Kullanıcı dostu arayüzü sayesinde API testlerini hızlıca yapabilirsiniz.
- İşbirliği: Ekip üyeleri arasında koleksiyonları paylaşabilir ve işbirliği yapabilirsiniz.
- Ortam Değişkenleri: Farklı ortaml arasında geçiş yaparak testlerinizi kişiselleştirebilirsiniz.
- Otomasyon: Postman Runner veya Newman gibi araçlar ile API testlerinizi otomatikleştirebilirsiniz