Postacı Koleksiyonu

Koleksiyon, Postman’in işi düzenlediği birimdir: her biri kendi metodu, URL’si, başlıkları, gövdesi ve isteğe bağlı betikleriyle istekler içeren bir klasör ağacı ve bunların ortak kullandığı değişkenler. Dışa aktarıldığında başka bir kişinin, bir CI işinin ya da Newman’ın (Postman’in komut satırı çalıştırıcısı) açıp çalıştırabileceği bir JSON dosyasıdır.

Nasıl çalışır

İstekler {{baseUrl}} ve {{token}} gibi değişkenlere başvurur; bunlar bir ortamdan (environment) gelir, böylece aynı koleksiyon yerelde, test ortamında ve canlıda çalışır. Bir isteğe bağlı test betikleri yanıtı doğrular ve bir sonraki istek için değişken ayarlayabilir — girişten bir token yakalayıp sonraki her çağrıda kullanmak gibi.

Yaygın yanılgı

Koleksiyonun dokümantasyon olduğu sanılır. Koleksiyon API’nin neyi kabul ettiğini değil, birinin bir zamanlar ne gönderdiğini kaydeder; aylarca eskimiş olup, başarısız olacak isteği kimse eklemediği için yeşil çalışmaya devam edebilir. API’nin OpenAPI belgesinden üretmek onu dürüst tutar.

Burada deneyin

Her dokümantasyon sayfası o API için, OpenAPI belgesiyle aynı tanımlardan üretilmiş bir Postman koleksiyonu dışa aktarır. Buradaki çalışma alanı da aynı mantıkla işler: kaydedilen her istek için değişkenler, yakalamalar ve doğrulamalar.

İlgili

• OpenAPI nedir
• Başlangıç rehberi

Kaynaklar

• Postman collection schema

Diğer terimler

• OpenAPI — Bir HTTP API’sinin yollarını, parametrelerini, gövdelerini ve yanıtlarını JSON ya da YAML olarak anlatan, makinenin okuyabildiği tarif.
• REST API — Bir sistemi adreslenebilir kaynaklar olarak modelleyen ve onları standart HTTP metotlarıyla değiştiren API.
• API uç noktası (endpoint) — Bir URL ile bir HTTP metodunun birleşimi — bir istemcinin çağırabileceği en küçük API birimi.
• Sorgu parametreleri — URL’deki ? işaretinden sonra gelen, bir uç noktanın döndürdüğünü filtrelemek, sıralamak ya da sayfalamak için kullanılan anahtar=değer çiftleri.
• Yollar — Bir URL yolunun, /orders/42’deki 42 gibi, belirli bir kaynağı tanımlayan değişken parçası.
• HTTP — Her istek ve yanıtla birlikte, gövdeden ayrı olarak gönderilen ad–değer üst verisi.

Bu sayfayı İngilizce okuyun

Tüm sözlük maddeleri · Test teknikleri · 39 mock REST API’nin tamamı

Son güncelleme 16 Ekim 2026