Postman Nedir? API Test Aracı Kullanım Rehberi

Postman Nedir ve Neden API Geliştirmede Bu Kadar Önemli?

Postman, API geliştirme yaşam döngüsünün tüm aşamalarını kapsayan profesyonel bir API platformudur. Başlangıçta basit bir REST istemcisi olarak ortaya çıkmasına rağmen, bugün API oluşturma, test etme, belgeleme, izleme ve otomasyon süreçlerini tek bir çatı altında toplayan tam kapsamlı bir ekosisteme dönüşmüştür. Mayıs 2026 itibarıyla Postman v12 sürümü kullanımda olup, 15 Mayıs 2026'da yayınlanan 12.10.6 sürümü en güncel kararlı sürümdür.

Postman'ın kullanıcı dostu arayüzü, geliştiricilerin HTTP, REST, SOAP, GraphQL, gRPC, WebSocket, SSE ve MQTT gibi farklı API teknolojileriyle çalışmasını kolaylaştırır. Platform, desktop ve web uygulaması yanında Postman CLI, Newman komut satırı aracı, Postman Flows düşük kodlu otomasyon motoru ve Spec Hub gibi entegre araçlar sunarak modern API geliştirme ihtiyaçlarına kapsamlı çözümler sağlar.

Postman Platformunun Temel Bileşenleri ve Özellikleri

Postman Desktop ve Web Uygulaması

Postman'ın ana uygulaması, Windows, macOS ve Linux sistemlerde çalışan desktop versiyonu ile tarayıcı tabanlı web versiyonundan oluşur. Desktop uygulaması, yerel dosya sistemiyle entegrasyon ve daha iyi performans sunarken, web versiyonu herhangi bir kurulum gerektirmeden tarayıcıdan doğrudan erişim imkanı sağlar. Her iki versiyon da aynı çalışma alanlarını ve koleksiyonları senkronize ederek ekipler arası kesintisiz işbirliği sağlar.

Mayıs 2026'da eklenen yeni özellikler arasında webhookları Postman içinde test etme ve hata ayıklama özelliği bulunur. Bu özellik, genel HTTPS URL'leri oluşturmanıza, istek yüklerini ve başlıkları gerçek zamanlı inceleyebilmenize, gelen istekleri yerel sunucunuza iletmenize ve dinamik yanıtları yapılandırmanıza olanak tanır. Solo, Team ve Enterprise planlarında kullanılabilir.

Postman CLI ve Newman Komut Satırı Araçları

Postman CLI, API koleksiyonlarını komut satırından çalıştırmak, API şemalarını lint etmek ve güvenlik/yönetişim denetimleri yapmak için kullanılan modern bir araçtır. Ocak 2026'da yayınlanan v1.27.0 sürümü ile Linux ARM64 sistemleri için yerel destek eklenmiştir. CI/CD pipeline'larınıza entegre ederek otomatik testler ve validasyon süreçleri kurabilirsiniz.

Newman ise Postman Koleksiyonlarını doğrudan komut satırından çalıştırmanıza ve test etmenize olanak tanır. Jenkins, GitLab CI, GitHub Actions gibi CI/CD araçlarıyla sorunsuz entegrasyon sağlar ve test sonuçlarını farklı formatlarda (JSON, HTML, JUnit) raporlayabilir. Özellikle regresyon testleri ve otomatik entegrasyon testleri için ideal bir çözümdür.

Postman Flows ve Agent Mode Otomasyon Özellikleri

Postman Flows, düşük kodlu bir otomasyon motoru olarak istekleri zincirleme, verileri dönüştürme ve iş akışları oluşturma imkanı sunar. Mayıs 2026 itibarıyla ortam değişkenleri, kasa sırları ve yerel Git desteği gibi gelişmiş özelliklerle donatılmıştır. Görsel bir arayüzle API çağrılarını birbirine bağlayabilir, veri dönüşümleri yapabilir ve karmaşık iş mantığını kodlamadan uygulayabilirsiniz.

Agent Mode, yapay zeka destekli bir özelliktir ve doğal dil kullanarak API yaşam döngüsündeki görevleri otomatikleştirir. Bu özellik, AI Request Blocks for Postman Notebooks ile birlikte kullanıldığında yapay zeka modelleriyle etkileşimli deneyimler oluşturmanıza olanak tanır. Tekrarlayan görevleri otomatikleştirmek ve API testlerini hızlandırmak için kullanışlıdır.

Postman ile API Testi Nasıl Yapılır: Adım Adım Uygulama

Postman Kurulumu ve İlk Yapılandırma

Postman'ı kullanmaya başlamak için önce postman.com adresinden uygulamayı indirin veya web versiyonunu kullanın. Desktop versiyonu için Windows'ta .exe, macOS'ta .dmg ve Linux'ta AppImage veya Snap paket formatlarından birini seçebilirsiniz. Kurulum tamamlandıktan sonra bir Postman hesabı oluşturmanız gerekir; bu sayede çalışmalarınız bulut üzerinde senkronize edilir ve farklı cihazlardan erişebilirsiniz.

İlk oturum açışta karşınıza çalışma alanı (workspace) seçimi gelir. Kişisel projeler için "Personal" çalışma alanını, ekip işbirliği için "Team" çalışma alanını tercih edebilirsiniz. Mart 2026'dan itibaren ücretsiz planda ekip işbirliği desteği kaldırıldığından, birden fazla kullanıcıyla çalışmak için en az Basic plan gereklidir. Çalışma alanınızı oluşturduktan sonra ortam değişkenlerini (environment variables) yapılandırarak farklı sunucu ortamları (development, staging, production) arasında kolayca geçiş yapabilirsiniz.

İlk API İsteği Oluşturma ve Gönderme

Yeni bir istek oluşturmak için sol üst köşedeki "New" butonuna tıklayın ve "HTTP Request" seçeneğini seçin. İstek URL'sini gireceğiniz alana hedef API endpoint'inizi yazın, örneğin: https://api.example.com/users. HTTP metodunu (GET, POST, PUT, DELETE, PATCH vb.) dropdown menüden seçin. GET istekleri için genellikle ek yapılandırma gerekmezken, POST ve PUT istekleri için request body'yi "Body" sekmesinden yapılandırmanız gerekir.

Headers sekmesinden özel başlıklar ekleyebilirsiniz. Authorization başlığı için ayrı bir "Auth" sekmesi bulunur; burada Bearer Token, API Key, OAuth 2.0, AWS Signature ve daha fazla kimlik doğrulama yöntemini yapılandırabilirsiniz. Params sekmesinden query parametrelerini ekleyebilirsiniz; Postman bunları otomatik olarak URL'ye ekler. "Send" butonuna tıkladığınızda, alttaki panelde yanıt gösterilir: JSON/XML formatında body, HTTP status kodu, yanıt süre bilgisi ve yanıt başlıkları.

Koleksiyon Oluşturma ve Organize Etme

İlgili API isteklerini koleksiyonlar (collections) içinde gruplandırarak organize edebilirsiniz. Sol panelden "Collections" sekmesine geçin ve "+" butonuyla yeni koleksiyon oluşturun. Koleksiyon içine klasörler ekleyerek istekleri kategorize edebilir, örneğin "Auth", "Users", "Products" gibi. Her koleksiyona açıklama, pre-request script'ler ve test script'leri ekleyebilirsiniz.

Bir koleksiyonu takımınızla paylaşmak için koleksiyon üzerine sağ tıklayıp "Share Collection" seçeneğini kullanın. Koleksiyonu JSON formatında dışa aktarıp sürüm kontrol sistemine ekleyebilir veya başkalarına gönderebilirsiniz. Postman 12.10.1 sürümü ile Yerel Görünümde API spesifikasyonlarıyla koleksiyonları senkronize etme özelliği geliştirilmiştir; OpenAPI 2.0, 3.0 ve 3.1 spesifikasyonları için yerel Git deposu desteği bulunur.

Test Script'leri Yazma ve Otomasyon

Postman, JavaScript tabanlı test script'leri yazmanıza olanak tanır. Her isteğin "Tests" sekmesinden test kodları ekleyebilirsiniz. Örneğin, bir yanıtın status kodunu kontrol etmek için:

pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});
pm.test("Response has user data", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.name).to.exist;
    pm.expect(jsonData.email).to.be.a('string');
});

Test sonuçları, istek gönderildikten sonra "Test Results" sekmesinde gösterilir. Her test için pass/fail durumu ve hata mesajları görüntülenir. Ortam değişkenlerini test script'lerinde kullanarak dinamik testler yazabilirsiniz. Örneğin, bir API'den dönen token'ı sonraki istekler için saklamak istiyorsanız:

var jsonData = pm.response.json();
pm.environment.set("auth_token", jsonData.token);

Koleksiyon çalıştırıcı (Collection Runner) ile bir koleksiyondaki tüm istekleri sırayla otomatik çalıştırabilirsiniz. Sağ üst köşeden "Run collection" butonuna tıklayın, çalışma ortamını ve iterasyon sayısını seçin. Ücretsiz planda sınırsız Collection Runner kullanımı bulunur, ancak dakika başına 120 istek limiti vardır.

Postman Fiyatlandırma Planları ve Limitler

Postman Free Plan Özellikleri ve Sınırlamalar

Ücretsiz plan, bireysel geliştiriciler için 0 dolar maliyetle sunulur. Mart 2026'dan itibaren yalnızca 1 kullanıcı ile sınırlandırılmıştır ve ekip işbirliği desteği kaldırılmıştır. Ancak bireysel kullanıcılar için plan daha cömert hale gelmiştir: ayda 50 AI kredisi, sınırsız Koleksiyon Çalıştırıcı, sınırsız Performans Testi çalıştırması, sınırsız spesifikasyonlar ve sahte sunucular, sınırsız manuel Flows ve yerel Git entegrasyonu sunar.

Teknik sınırlamalar arasında aylık 10.000 API çağrısı (önceki 1.000'den artırıldı), dakika başına 300 istek API erişim oranı ve response body için 300KB boyut limiti bulunur. Postman konsolu için bu limit 10KB'tır. Doğrudan içe aktarma sırasında maksimum dosya boyutu 5MB'tır ve ücretsiz planda dakika başına en fazla beş koleksiyon içe aktarabilirsiniz (her biri 500KB'tan büyükse).

Postman Basic ve Professional Plan Karşılaştırması

Basic plan, küçük ekipler için sınırsız ekip işbirliği sunarken, Professional plan CI/CD entegrasyonları, özel alan adları, artırılmış izleme limitleri ve çalışma alanı düzeyinde rol tabanlı erişim kontrolü (RBAC) gibi gelişmiş özellikler içerir. İş ortağı çalışma alanları ve 90 günlük koleksiyon kurtarma seçenekleri de Professional planda bulunur.

Postman Enterprise Plan ve Kullanım Bazlı Ücretler

Enterprise plan, yıllık faturalandırmada kullanıcı başına ayda yaklaşık 49 dolar veya özel fiyatlandırma ile sunulur. Gelişmiş güvenlik özellikleri (SSO, SAML, SCIM provizyonu), özel destek, denetim günlükleri ve daha yüksek veya sınırsız kullanım limitleri içerir. SOC 2, HIPAA veya GDPR uyumluluğu gerektiren düzenlenmiş sektörler için zorunludur. Sınırsız koleksiyon çalıştırması ve öncelikli teknik destek Enterprise planın öne çıkan özellikleridir.

Kullanım bazlı aşım ücretleri tüm planlarda geçerlidir. Ücretsiz planda dahil olan 50 kredi/kullanıcı/ay'ın ötesinde ek 400 kredi için kullanıcı başına ayda 5 dolar ödenir. Basic planda ayda 400 kredinin ötesinde kredi başına 0,035 dolar, Professional planda kredi başına 0,030 dolar ücret uygulanır. AI kredileri hızlı tüketilebilir; bir işlem yüzlerce veya binlerce kredi harcayabilir, bu nedenle AI özelliklerini yoğun kullanıyorsanız bütçenizi buna göre ayarlamanız önerilir.

Postman İleri Düzey Kullanım ve Best Practices

Postman API Hız Limitleri ve Performans Optimizasyonu

Postman API'si, kullanıcı başına dakika 300 istek ile sınırlandırılmıştır. Bu limit, Postman'ın kendi API'sine yapılan çağrılar içindir, test ettiğiniz üçüncü parti API'lere değil. Varsayılan hız limiti, kampanya kimliği başına 10 TPS (saniyedeki işlem sayısı) olup, tüm API'ler arasında paylaşılır. Kampanyanız saniyede 50'den fazla API isteği veya saniyede 100'den fazla mesaj segmenti yapıyorsa, büyük kampanya formu göndermeniz gerekir.

Sahte sunucular için dakika başına 120 istek limiti vardır ve bu hem genel hem özel sahte sunucular için geçerlidir. Performansı optimize etmek için koleksiyonlarınızı birkaç yüz istekten fazla içermeyecek şekilde bölmelisiniz. Daha büyük koleksiyonlar, Collection Runner'da performans sorunlarına yol açabilir. Yanıt boyutu limiti 300KB'dır; bundan daha büyük yanıtlar kalıcı olmaz ve koleksiyon çalıştırmasında görüntülenemez.

Postman Monit��rleri ve Otomatik Test Zamanlaması

Postman Monitörleri, API'lerinizi belirli aralıklarla otomatik olarak test ederek uptime ve performans takibi yapmanıza olanak tanır. Nisan 2026'da bölge desteği genişletilmiş olup şu bölgeler desteklenmektedir: Asya Pasifik, Avrupa, Hindistan, Japonya ve ABD Doğu. Her monitör için çalışma sıklığı (5 dakika, 15 dakika, saatlik, günlük vb.), çalışma bölgesi ve bildirim ayarlarını yapılandırabilirsiniz.

Basic plan ayda 10.000 izleme isteği sunarken, Professional ve Enterprise planlar daha yüksek limitlerle gelir. Monitör çalıştırmaları başarısız olduğunda e-posta, Slack, PagerDuty gibi kanallardan bildirim alabilirsiniz. Mart 2026'da kullanım metriklerinde yapılan iyileştirmelerle raporlar artık aylık yerine saatlik güncellemelerle sunulmaktadır ve daha net iş ortağı içgörüleri için çubuk grafikler yerine Sankey grafikler kullanılmaktadır.

Postman Spec Hub ve API Belirtim Yönetimi

Spec Hub, API belirtimlerini merkezi olarak yönetmek için kullanılan bir özelliktir. Mayıs 2026'da Smithy 2.0 desteği eklenmiştir ve artık Smithy 2.0, protobuf 2, protobuf 3 ve GraphQL belirtimlerini destekler. API-first yaklaşımı benimseyen ekipler için Spec Hub, API tasarımını kod yazmadan önce tanımlamanıza ve doğrulamanıza olanak tanır.

OpenAPI 3.1 belirtimlerinden Postman koleksiyonları otomatik oluşturabilir ve senkronize edebilirsiniz. Yerel Git entegrasyonu sayesinde API spesifikasyonlarınızı Git depolarıyla senkronize edebilir, değişiklikleri takip edebilir ve versiyon kontrolü yapabilirsiniz. 8 Mayıs 2026'da eklenen Playwright testlerinden API bağımlılıklarını doğrulamak için Uygulama Envanteri desteği, end-to-end testlerde kullanılan API'leri izlemenizi sağlar.

Postman Güvenlik ve Compliance Özellikleri

Enterprise planda SSO (Single Sign-On), SAML ve SCIM provizyonu gibi kurumsal güvenlik özellikleri bulunur. Denetim günlükleri (audit logs) sayesinde çalışma alanındaki tüm aktiviteleri takip edebilir, kim hangi kaynağa ne zaman erişti görebilirsiniz. Mart 2026'da Enterprise planlarında dahili API'leri izlemek için yeni özellikler tanıtılmıştır.

Kasa sırları (vault secrets) özelliği, hassas bilgileri (API anahtarları, şifreler vb.) güvenli şekilde saklamanıza olanak tanır. Bu bilgiler şifreli olarak saklanır ve sadece yetkili kullanıcılar tarafından erişilebilir. Ortam değişkenlerinde saklanan hassas bilgiler takım üyeleriyle paylaşılırken şifreli kalır. GDPR, HIPAA ve SOC 2 uyumluluğu gerektiren projeler için Enterprise plan zorunludur.

Postman Kullanımında Dikkat Edilmesi Gereken Önemli Noktalar

Kritik Uyarı: Mart 2026'dan itibaren ücretsiz planda ekip işbirliği desteği kaldırılmıştır. Birden fazla kullanıcıyla çalışmanız gerekiyorsa en az Basic plana geçmeniz zorunludur. Mevcut ücretsiz plandaki ekip çalışma alanları, fiyatlandırma değişikliği sonrası solo plan kısıtlamalarına tabi olacaktır.

Postman CLI kullanırken dikkat etmeniz gereken bir nokta, Linux ARM64 desteğinin Ocak 2026'da v1.27.0 ile gelmiş olmasıdır. Daha eski sürümlerde ARM64 sistemlerde sorun yaşayabilirsiniz. Newman ile CI/CD entegrasyonu yaparken, paralel çalıştırmalar yapıyorsanız hız limitlerini göz önünde bulundurmalısınız; çok sayıda koleksiyon çalıştırması aynı anda yapıldığında dakika başına 300 istek limitini aşabilirsiniz.

API yanıt boyutu 300KB'ı aşıyorsa Postman bu yanıtı tam olarak kaydetmez. Büyük veri setleriyle çalışıyorsanız pagination kullanarak yanıt boyutunu düşürmeniz veya sadece gerekli alanları sorgulamanız önerilir. İçe aktarma işlemlerinde 5MB dosya boyutu limiti bulunur; daha büyük koleksiyonları parçalara ayırarak içe aktarmalısınız. Webhook test özelliği 14 Mayıs 2026'da Postman 12.10.5 ile eklendi ve Solo, Team, Enterprise planlarında mevcuttur; Free planda kullanılamaz.

Özet: Postman'ın Modern API Geliştirmedeki Rolü

Postman, 2026 itibarıyla API geliştirme ekosisteminin merkezinde yer alan, sürekli gelişen bir platformdur. Mayıs 2026'da yayınlanan v12.10.6 sürümü ve son altı ayda eklenen webhook test özelliği, SDK güncelleme otomasyonu, Smithy 2.0 desteği ve genişletilmiş monitör bölgeleri gibi yenilikler, platformun güncel ve rekabetçi kalmasını sağlar. Ücretsiz plandan Enterprise plana kadar geniş fiyatlandırma seçenekleri, bireysel geliştiricilerden büyük kurumlara kadar her ölçekte ekibin ihtiyaçlarını karşılar.

Platform, API yaşam döngüsünün her aşamasını destekler: Spec Hub ile tasarım, Collections ve Flows ile test, Monitors ile izleme, CLI ve Newman ile CI/CD entegrasyonu. Yapay zeka destekli Agent Mode ve AI Request Blocks özellikleri, otomasyon süreçlerini hızlandırırken, yerel Git entegrasyonu sürüm kontrolünü kolaylaştırır. Dakika başına 300 istek API limiti, 10 TPS varsayılan hız limiti ve 300KB yanıt boyutu kısıtlaması gibi teknik sınırları bilerek çalışmanız, beklenmedik sorunları önler.

Mart 2026 fiyatlandırma değişiklikleri, ücretsiz planı bireysel kullanıcılar için iyileştirirken ekip işbirliğini ücretli planlara taşımıştır. Bu değişiklik, profesyonel ekiplerin Basic plan (yıllık 14$/kullanıcı/ay) veya daha üst planları tercih etmelerini gerektirmektedir. Postman'ın sunduğu kapsamlı araç seti, doğru planla birleştirildiğinde API geliştirme sürecinizi önemli ölçüde hızlandırabilir ve kaliteyi artırabilir.

Sıkça Sorulan Sorular

Postman ücretsiz planda ekip çalışması yapılabilir mi?

Hayır, Mart 2026'dan itibaren ücretsiz plan yalnızca tek kullanıcı ile sınırlandırılmıştır ve ekip işbirliği desteği kaldırılmıştır. Ekip çalışması için en az Basic plana (yıllık faturalamada kullanıcı başına ayda 14 dolar) geçmeniz gerekir. Basic plan sınırsız kullanıcı desteği ve bulut tabanlı entegrasyonlar sunar.

Postman API hız limitleri nelerdir ve nasıl aşılır?

Postman API'si kullanıcı başına dakika 300 istek ile sınırlandırılmıştır. Kampanya bazlı varsayılan limit ise saniyede 10 işlemdir (10 TPS). Saniyede 50'den fazla API isteği veya 100'den fazla mesaj segmenti gerektiren kampanyalar için büyük kampanya formu göndermelisiniz. Sahte sunucular için dakika başına 120 istek limiti vardır ve bu değiştirilemez.

Postman CLI ve Newman arasındaki fark nedir?

Postman CLI, API koleksiyonlarını çalıştırmanın yanı sıra API şemalarını lint etme ve güvenlik/yönetişim denetimleri yapma gibi geniş yetenekler sunar. Newman ise özellikle Postman Koleksiyonlarını komut satırından çalıştırmaya ve test etmeye odaklanmış daha özel bir araçtır. Her ikisi de CI/CD pipeline'larına entegre edilebilir, ancak Postman CLI daha modern ve kapsamlı özellikler içerir.

Postman yanıt boyutu limiti nedeniyle büyük API yanıtlarını nasıl test edebilirim?

Postman, saklanan yanıt gövdelerinin boyutunu 300KB ile sınırlar; bundan büyük yanıtlar kalıcı olmaz. Büyük veri setleriyle çalışıyorsanız API yanıtlarında pagination kullanın veya sadece gerekli alanları sorgulayan parametreler ekleyin. Alternatif olarak, yanıt verilerini test script'lerinde işleyip sadece özet metrikleri kaydetmek de bir çözüm olabilir.

Postman webhook test özelliği hangi planlarda kullanılabilir?

Webhook test ve hata ayıklama özelliği, 14 Mayıs 2026'da Postman 12.10.5 sürümü ile eklenmiştir ve Solo, Team ve Enterprise planlarında mevcuttur. Free planda bu özellik bulunmaz. Özellik, genel HTTPS URL'leri oluşturma, istek yüklerini gerçek zamanlı inceleme, gelen istekleri yerel sunucuya iletme ve dinamik yanıtları yapılandırma yetenekleri sunar.

Yazan Celil Uyanikoglu

25 yıldır bilgi işlem piyasasında farklı dallarda uzmanlaşan bir Bilgisayar Mühendisi

X @