Postman Klavuz

🚀 Akıllı Özet

Postman Geliştirme ve test ortamlarında verimli API iş akışı yönetimi için tasarlanmış ölçeklenebilir bir API test aracıdır. Sorunsuz organizasyon, iş birliği ve otomasyon sağlayarak kritik API test görevlerini erişilebilir ve tekrarlanabilir hale getirir.

  • Temel Prensip: Postman API isteği oluşturma, test etme ve yönetme için hem manuel hem de otomatik test iş akışlarını destekleyen birleşik bir çalışma alanı sağlar.
  • Uygulama Odağı: İstekleri, daha sonra klasörlere bölünebilen ve ekip üyeleri arasında kolayca paylaşılabilen koleksiyonlara düzenleyin; böylece verimli bir iş birliği sağlanmış olur.
  • Parametreleme Kuralı: İstekleri parametrelendirmek için çift kıvırcık parantezli ortam ve genel değişkenleri kullanın (örneğin, {{url}}), böylece yedeklilik azalır ve birden fazla API uç noktasında yeniden kullanım sağlanır.
  • Test Temelleri: Yazmak JavaTestler sekmesindeki betik tabanlı testler, durum kodlarını, yanıt gövdelerini ve beklenen değerleri doğrulamak, sağlam API kapsamını ve güvenilirliği sağlamak için kullanılır.
  • Otomasyon Yolu: Koleksiyonları, CI/CD entegrasyonu ve komut satırı arayüzlerini kullanarak otomatik toplu yürütme için olmazsa olmaz olan Koleksiyon Çalıştırıcısı veya Newman aracılığıyla çalıştırın.

Postman Klavuz

Nedir? Postman?

Postman CI/CD hattına hızla entegre olabilen ölçeklenebilir bir API test aracıdır. 2012 yılında Abhinav Asthana tarafından test ve geliştirmede API iş akışını basitleştirmek amacıyla bir yan proje olarak başlatılmıştır. API, Uygulama Programlama Arayüzü anlamına gelir ve yazılım uygulamalarının API çağrıları aracılığıyla birbirleriyle iletişim kurmasını sağlar.

👉 Ücretsiz Canlı API Test Projesine Kaydolun

Neden kullan Postman?

Günümüzde 4 milyondan fazla kullanıcısı olan Postman Yazılım, aşağıdaki nedenlerden dolayı tercih edilen bir araç haline gelmiştir:

  1. Erişilebilirlik – Kullanmak için Postman Araç, kişinin kendi hesabına giriş yapması yeterli olacak ve bu sayede dosyalara her zaman, her yerden kolayca erişilebilecek. Postman uygulama bilgisayara kurulur.
  2. Koleksiyonların Kullanımı – Postman kullanıcıların kendi koleksiyonları için koleksiyon oluşturmasına olanak tanır Postman API çağrıları. Her koleksiyon, alt klasörler ve birden fazla istek oluşturabilir. Bu, test paketlerinizi düzenlemenize yardımcı olur.
  3. İş Birliği – Koleksiyonlar ve ortamlar içe veya dışa aktarılabilir, böylece dosya paylaşımı kolaylaşır. Koleksiyonları paylaşmak için doğrudan bir bağlantı da kullanılabilir.
  4. Ortam Oluşturma – Birden fazla ortama sahip olmak, aynı koleksiyonu farklı bir ortam için kullanabilmeniz sayesinde test tekrarlarını azaltır. Parametrelendirme burada devreye girecek ve bunu sonraki derslerde ele alacağız.
  5. Testlerin Oluşturulması – Başarılı HTTP yanıt durumunu doğrulama gibi test kontrol noktaları her birine eklenebilir Postman API çağrıları, güvenliğin sağlanmasına yardımcı olur test kapsamı.
  6. Otomasyon Testi – Collection Runner veya Newman kullanımıyla testler birden fazla yinelemede çalıştırılabilir ve tekrarlayan testler için zaman tasarrufu sağlanır.
  7. Hata ayıklama – Postman Konsol, hangi verilerin alındığını kontrol etmeye yardımcı olur ve böylece testlerin hata ayıklamasını kolaylaştırır.
  8. Sürekli Entegrasyon – Sürekli entegrasyonu destekleyebilme özelliği ile geliştirme uygulamaları sürdürülmektedir.

Nasıl kullanılır? Postman API'leri yürütmek için

Aşağıda Postman Çalışma Alanı. Adım adım süreci inceleyelim Nasıl kullanılır? Postman ve farklı özellikleri Postman araç!

Nasıl Kullanılır Postman API'leri Çalıştırmak için

  1. Yeni – Burada yeni bir istek, koleksiyon veya ortam oluşturacaksınız.
  2. İçe Aktar – Bu, bir koleksiyon veya ortamı içe aktarmak için kullanılır. Dosyadan, klasörden, bağlantıdan içe aktarma veya ham metni yapıştırma gibi seçenekler mevcuttur.
  3. Runner – Otomasyon testleri Collection Runner aracılığıyla yürütülebilir. Bu konu bir sonraki derste daha detaylı tartışılacaktır.
  4. Yeni Aç – Yeni bir sekme açın, Postman Bu butona tıklayarak Pencere veya Runner Penceresi'ne ulaşabilirsiniz.
  5. Çalışma Alanım – Bireysel olarak veya ekip olarak yeni bir çalışma alanı oluşturabilirsiniz.
  6. Davet Et – Ekip üyelerini davet ederek bir çalışma alanında işbirliği yapın.
  7. Geçmiş – Gönderdiğiniz geçmiş istekler Geçmiş'te görüntülenecektir. Bu, yaptığınız eylemleri izlemeyi kolaylaştırır.
  8. Koleksiyonlar – Koleksiyonlar oluşturarak test paketinizi düzenleyin. Her koleksiyonun alt klasörleri ve birden fazla isteği olabilir. Bir istek veya klasör de çoğaltılabilir.
  9. İstek sekmesi – Bu, üzerinde çalıştığınız isteğin başlığını görüntüler. Varsayılan olarak, başlığı olmayan istekler için “Başlıksız İstek” görüntülenecektir.
  10. HTTP İsteği – Buna tıklandığında GET, POST, COPY, DELETE vb. gibi farklı isteklerin açılır listesi görüntülenir. Postman API testinde en sık kullanılan istekler GET ve POST'tur.
  11. İstek URL'si – Uç nokta olarak da bilinir, burası API'nin iletişim kuracağı bağlantıyı tanımlayacağınız yerdir.
  12. Kaydet – Bir istekte değişiklik varsa, yeni değişikliklerin kaybolmaması veya üzerine yazılmaması için kaydet seçeneğine tıklamak şarttır.
  13. Parametreler – Buraya bir istek için gereken anahtar değerleri gibi parametreleri yazacaksınız.
  14. Yetkilendirme – API'lere erişmek için uygun yetkilendirme gereklidir. Bu yetkilendirme, kullanıcı adı ve parola, taşıyıcı token vb. şeklinde olabilir.
  15. Başlıklar – Kuruluşun ihtiyaçlarına bağlı olarak içerik türü JSON gibi başlıkları ayarlayabilirsiniz.
  16. Gövde – Burası bir istekteki ayrıntıların özelleştirilebileceği yerdir, genellikle bir POST isteğinde kullanılır.
  17. Ön İstek Komut Dosyası – Bunlar istekten önce yürütülecek komut dosyalarıdır. Genellikle testlerin doğru ortamda çalıştırılmasını sağlamak için ayar ortamına yönelik ön istek komut dosyaları kullanılır.
  18. Testler – Bunlar, istek sırasında çalıştırılan betiklerdir. Yanıt durumunun uygun olup olmadığını, alınan verilerin beklendiği gibi olup olmadığını ve diğer testleri doğrulamak için kontrol noktaları oluşturduğundan, testlerin olması önemlidir.

GET İstekleriyle Çalışmak

Get istekleri, belirtilen URL'den bilgi almak için kullanılır. Uç noktada herhangi bir değişiklik yapılmayacaktır.

Bu makaledeki tüm örnekler için aşağıdaki URL'yi kullanacağız Postman öğretici https://jsonplaceholder.typicode.com/users

Çalışma alanında

  1. HTTP isteğinizi GET olarak ayarlayın.
  2. İstek URL alanına bağlantıyı girin
  3. Gönder'i tıklayın
  4. "200 OK" mesajını göreceksiniz
  5. Testinizin başarıyla çalıştığını gösteren gövdede 10 kullanıcı sonucu olmalıdır.

Alma İstekleri ile Çalışma

* Not: Get'in kullanılabileceği durumlar olabilir Postman İstek başarısız olabilir. Geçersiz bir istek URL'sinden kaynaklanıyor olabilir veya kimlik doğrulaması gerekebilir.

POST İstekleriyle Çalışmak

Post istekleri, kullanıcının uç noktaya veri eklemesiyle veri manipülasyonu içerdiğinden, Get isteklerinden farklıdır. Önceki eğitimde Get isteği bölümündeki verileri kullanarak şimdi kendi kullanıcımızı ekleyelim.

) 1 Adım Yeni bir istek oluşturmak için yeni bir sekmeye tıklayın.

Gönderi İstekleriyle Çalışmak

) 2 Adım Yeni sekmede

  1. HTTP isteğinizi POST olarak ayarlayın.
  2. Aynı bağlantıyı istek URL'sine girin: https://jsonplaceholder.typicode.com/users
  3. Gövde sekmesine geçin

Gönderi İstekleriyle Çalışmak

) 3 Adım Vücutta,

  1. Ham'ı tıklayın
  2. JSON'u seçin

Gönderi İstekleriyle Çalışmak

) 4 Adım Önceki get isteğinden sadece bir kullanıcı sonucunu kopyalayıp yapıştırın. Kodun eşleştirilmiş kıvırcık parantezler ve köşeli parantezler ile doğru şekilde kopyalandığından emin olun. id'yi 11 ve name'i istediğiniz herhangi bir isimle değiştirin. Adres gibi diğer ayrıntıları da değiştirebilirsiniz.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

Gönderi İstekleriyle Çalışmak

* Not: Çevrimiçi Gönderi isteği, istenen verilerin oluşturulmasını sağlamak için doğru biçime sahip olmalıdır. İsteğin JSON biçimini kontrol etmek için Get first kullanmak iyi bir uygulamadır. Bunun için şu araçları kullanabilirsiniz: https://jsonformatter.curiousconcept.com/

Gönderi İstekleriyle Çalışmak

) 5 Adım Daha sonra,

  1. Gönder'e tıklayın.
  2. Durum: 201 Oluşturuldu görüntülenmeli
  3. Gönderilen veriler gövdede görünüyor.

Gönderi İstekleriyle Çalışmak

İstekler Nasıl Parametreleştirilir?

Veri Parametreleştirmesi en kullanışlı özelliklerden biridir. PostmanAynı istekleri farklı verilerle oluşturmak yerine, parametreli değişkenler kullanabilirsiniz. Bu veriler bir veri dosyasından veya bir ortam değişkeninden gelebilir. Parametrelendirme, aynı testlerin tekrarlanmasını önlemeye yardımcı olur ve yinelemeler şunlar için kullanılabilir: otomasyon testi.

Parametreler, çift kıvırcık parantezlerin kullanımıyla oluşturulur: {{sample}}. Önceki isteğimizde parametrelerin kullanımına dair bir örneğe bakalım:

İstekleri Parametreleştirme

Şimdi parametreli bir GET isteği oluşturalım.

) 1 Adım

  1. HTTP isteğinizi GET olarak ayarlayın
  2. Bu bağlantıyı girin: https://jsonplaceholder.typicode.com/users. Bağlantının ilk kısmını {{url}} gibi bir parametreyle değiştirin. İstek URL'si artık {{url}}/users olmalıdır.
  3. Gönder'i tıklayın.

Parametremizin kaynağını belirlemediğimiz için yanıt gelmemesi gerekiyor.

İstekleri Parametreleştirme

) 2 Adım Parametreyi kullanmak için ortamı ayarlamanız gerekir

  1. Göz simgesini tıklayın
  2. Değişkeni tüm koleksiyonlarda kullanılabilen global bir ortama ayarlamak için düzenle'ye tıklayın.

İstekleri Parametreleştirme

) 3 Adım Değişken olarak,

  1. adı https://jsonplaceholder.typicode.com olan URL'ye ayarlayın
  2. Kaydet'i tıklayın.

İstekleri Parametreleştirme

) 4 Adım Bir sonraki ekranı görürseniz kapat'ı tıklayın

İstekleri Parametreleştirme

) 5 Adım İsteğinizi alın bölümüne geri dönün ve ardından gönder'e tıklayın. Artık isteğinizle ilgili sonuçlar görünüyor olmalı.

İstekleri Parametreleştirme

* Not: Hatalardan kaçınmak için parametrelerinizin bir ortam değişkeni veya veri dosyası gibi bir kaynağa sahip olduğundan her zaman emin olun.

Nasıl oluşturulurum Postman Testler

Postman Testler Javaİsteklere eklenen ve başarılı veya başarısız durum, beklenen sonuçların karşılaştırılması vb. gibi sonuçları doğrulamanıza yardımcı olan betik kodları. Genellikle pm.test ile başlar. Diğer araçlarda bulunan assert ve doğrulama komutlarıyla karşılaştırılabilir.

Biraz temel yapalım API testi kullanma Postman Önceki dersteki parametreli isteklerimiz için.

) 1 Adım Önceki eğitimdeki GET kullanıcı isteğinize gidin.

  1. Testler sekmesine geçin. Sağ tarafta snippet kodları var.
  2. Parçacıklar bölümünden “Durum kodu: Kod 200” seçeneğine tıklayın.

Bölme otomatik olarak doldurulur

Oluştur Postman Testler

) 2 Adım Şimdi Gönder'e tıklayın. Test sonucu şimdi görüntülenmelidir.

Oluştur Postman Testler

) 3 Adım Test sekmesine geri dönün ve başka bir test ekleyelim. Bu sefer beklenen sonucu gerçek sonuçla karşılaştıracağız.

Parçacıklar bölümünden “Yanıt gövdesi:JSON değeri kontrolü”ne tıklayın. Leanne Graham'ın kullanıcı kimliği 1'e sahip olup olmadığını kontrol edeceğiz.

Oluştur Postman Testler

) 4 Adım

  1. Koddaki "Test Adınız" kısmını "Kimliği 1 olan kullanıcının Leanne Graham olup olmadığını kontrol edin" ile değiştirin, böylece test adı tam olarak neyi test etmek istediğimizi belirtir.
  2. jsonData.value değerini jsonData[0].name ile değiştirin. Yolu almak için, daha önce Sonuç Al bölümündeki gövdeyi kontrol edin. Leanne Graham'ın kullanıcı kimliği 1 olduğundan, jsonData ilk sonuçta yer alır ve 0 ile başlamalıdır. İkinci sonucu almak istiyorsanız, sonraki sonuçlar için jsonData[1] ve benzeri değerleri kullanın.
  3. Eşitliğe “Leanne Graham” girin
pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Oluştur Postman Testler

) 5 Adım Gönder'i tıklayın. Artık isteğiniz için iki başarılı test sonucu bulunmalıdır.

Oluştur Postman Testler

* Not: Oluşturulabilecek farklı türde testler vardır. Postman. Aracı keşfetmeye çalışın ve hangi testlerin ihtiyaçlarınıza uyacağını görün.

Koleksiyonlar Nasıl Oluşturulur

Koleksiyonlar, test paketlerinin düzenlenmesinde önemli bir rol oynar. İçe ve dışa aktarılabilirler, bu da koleksiyonların ekip içinde paylaşılmasını kolaylaştırır. Bu eğitimde, bir koleksiyonun nasıl oluşturulup çalıştırılacağını öğreneceğiz.

Bir koleksiyon oluşturmaya başlayalım:

) 1 Adım Sayfanın sol üst köşesindeki Yeni düğmesine tıklayın.

Koleksiyonlar Oluşturun

) 2 Adım Koleksiyon'u seçin. Koleksiyon oluştur penceresi açılmalıdır.

Koleksiyonlar Oluşturun

) 3 Adım İstediğiniz koleksiyon adını ve açıklamasını girin ve ardından oluştur'a tıklayın. Şimdi bir koleksiyon oluşturulmalıdır.

Koleksiyonlar Oluşturun

) 4 Adım Önceki Alma isteğine geri dönün. Kaydet'i tıklayın

Koleksiyonlar Oluşturun

) 5 Adım

  1. Seç Postman Test Koleksiyonu.
  2. Kaydet'e tıklayın Postman Test Koleksiyonu

Koleksiyonlar Oluşturun

) 6 Adım Postman test koleksiyonu artık bir istek içermelidir.

Koleksiyonlar Oluşturun

) 7 Adım Önceki Gönderi isteği için 4-5. adımları tekrarlayın, böylece koleksiyon artık iki isteğe sahip olur.

Koleksiyonlar Oluşturun

Collection Runner'ı Kullanarak Koleksiyonları Çalıştırma

Koleksiyon Çalıştırıcısı ve Newman olan bir koleksiyonu çalıştırmanın iki yolu vardır. Koleksiyonu Collection Runner'da çalıştırarak başlayalım.

) 1 Adım Sayfanın üst kısmında İçe Aktar düğmesinin yanında bulunan Runner düğmesine tıklayın.

Collection Runner'ı Kullanarak Koleksiyonları Çalıştırma

) 2 Adım Koleksiyon Koşucusu sayfası aşağıdaki gibi görünmelidir. Aşağıda çeşitli alanların açıklamaları yer almaktadır

Collection Runner'ı Kullanarak Koleksiyonları Çalıştırma

) 3 Adım Koş senin Postman Aşağıdakileri ayarlayarak Test Toplama işlemini gerçekleştirin:

  • Klinik Postman test koleksiyonu - Yinelemeleri 3 olarak ayarla
  • Gecikmeyi 2500 ms olarak ayarla
  • Çalıştır'a tıklayın Postman Test et… düğmesi

Collection Runner'ı Kullanarak Koleksiyonları Çalıştırma

) 4 Adım Çalıştır butonuna tıklandıktan sonra Çalıştırma Sonuçları sayfası görüntülenmelidir. Gecikmeye bağlı olarak testleri yürütülürken görmelisiniz.

  1. Testler bittiğinde, Başarılı veya Başarısız olup olmadığını test durumunu ve yineleme başına sonuçları görebilirsiniz.
  2. Alma İstekleri için Geçiş durumunu görüyorsunuz
  3. Post için herhangi bir testimiz olmadığından, isteğin herhangi bir testin bulunmadığına dair bir mesaj olması gerekir.

Collection Runner'ı Kullanarak Koleksiyonları Çalıştırma

Başarılı olup olmadığını ve verilerin oluşturulduğunu veya alındığını doğrulayabilmeniz için isteklerinizde testlerin bulunmasının ne kadar önemli olduğunu görebilirsiniz.

Newman Kullanarak Koleksiyonlar Nasıl Çalıştırılır

Bir koleksiyonu yönetmenin bir başka yolu da Newman'dır. Newman ve Collection Runner arasındaki temel farklar şunlardır:

  1. Newman için bir eklentidir Postman. Yerel Uygulamadan ayrı olarak yüklemeniz gerekecektir.
  2. Newman komut satırını kullanırken Collection Runner'ın bir GUI'si var.
  3. Newman sürekli entegrasyon için kullanılabilir.

Newman'ı kurmak ve koleksiyonumuzu buradan çalıştırmak için aşağıdakileri yapın:

) 1 Adım Bu bağlantıyı kullanarak nodejs'i yükleyin: http://nodejs.org/download/

) 2 Adım Komut satırını açın ve girin

 npm install -g newman

Newman şimdi bilgisayarınıza kurulmalıdır.

Newman'ı Kullanarak Koleksiyonları Çalıştırma

) 3 Adım Newman kurulduktan sonra geri dönelim. Postman workspace.Koleksiyonlar kutusunda, üç noktaya tıklayın. Seçenekler artık görünmelidir. Dışa Aktar'ı seçin.

Newman'ı Kullanarak Koleksiyonları Çalıştırma

) 4 Adım Koleksiyonu Koleksiyon v2.1 Olarak Dışa Aktar'ı (Önerilen) seçin ve ardından Dışa Aktar'a tıklayın.

Newman'ı Kullanarak Koleksiyonları Çalıştırma

) 5 Adım İstediğiniz konumu seçin ve ardından Kaydet'e tıklayın. Dosyanız için özel bir klasör oluşturmanız tavsiye edilir. Postman testler. Artık bir koleksiyon seçtiğiniz yerel dizine aktarılmalıdır.

) 6 Adım Ayrıca çevremizi de ihraç etmemiz gerekecek. Global'de ortam açılır menüsünün yanındaki göz simgesine tıklayın ve JSON Olarak İndir'i seçin. İstediğiniz konumu seçin ve ardından Kaydet'e tıklayın. Ortamın koleksiyonunuzla aynı klasörde olması tavsiye edilir.

Newman'ı Kullanarak Koleksiyonları Çalıştırma

) 7 Adım Ortam artık Koleksiyon ile aynı yerel dizine aktarılmalıdır.

) 8 Adım Şimdi komut satırına geri dönün ve dizini, koleksiyonu ve ortamı kaydettiğiniz yere değiştirin.

 cd C:\Users\Asus\Desktop\Postman Tutorial

) 9 Adım Bu komutu kullanarak koleksiyonunuzu çalıştırın:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

Çalıştırma sonuçları artık aşağıdaki gibi görünmelidir.

Newman'ı Kullanarak Koleksiyonları Çalıştırma

Kılavuzda, yürütme için bazı temel Newman kodlarına bir referans verilmiştir:

  1. Yalnızca bir koleksiyonu çalıştırın. Bu, ortam veya test verileri dosyası bağımlılığı yoksa kullanılabilir.
  2. newman run <collection name>
  3. Bir koleksiyon ve ortam çalıştırın. -e göstergesi çevre içindir.
  4. newman run <collection name> -e <environment name>
  5. İstediğiniz numarayla bir koleksiyon çalıştırın. yinelemelerden oluşur.
  6. newman run <collection name> -n <no.of iterations>
  7. Veri dosyasıyla çalıştırın.
  8. newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>
  9. Gecikme süresini ayarlayın. Önceki istek uç nokta sunucusunda işlenmeyi tamamlamadan başlatılan istekler nedeniyle gecikmeden çalıştırılırsa testler başarısız olabileceğinden bu önemlidir.
  10. newman run <collection name> -d <delay time>

Ürettiğimiz Postman mülakat soruları kılavuzu Mülakatı geçmenize ve yazılım testinde hayalinizdeki işe kavuşmanıza yardımcı olacaktır.

ortak Postman Sorun Giderme Senaryoları

  1. 401 Yetkisiz veya 403 Yasak Hataları

    Bu durum, isteğinizde geçerli kimlik doğrulama bilgilerinin bulunmaması durumunda gerçekleşir.
    Nasıl düzeltilir: Double- Yetkilendirme türünüzü (API Anahtarı, Taşıyıcı Belirteci veya Temel Yetkilendirme) kontrol edin. Belirteç kullanıyorsanız, sürelerinin dolmadığından emin olun. Gerekirse yeni belirteçler oluşturun veya oturum kimlik bilgilerini yenileyin.

  2. 400 Bad Request

    İstek sözdizimi veya parametreleri yanlış olduğunda bu hatayı alırsınız.
    Nasıl düzeltilir: JSON veya XML gövdenizi JSONLint gibi bir biçimlendirici kullanarak doğrulayın. Parametrelerinizin, büyük/küçük harf duyarlılığı ve veri türü de dahil olmak üzere API'nin beklentileriyle tam olarak eşleştiğinden emin olun.

  3. 500 Dahili Sunucu Hatası

    Bu genellikle arka uçta oluşan bir sorundur ancak yükünüz düzgün yapılandırılmadığında da ortaya çıkabilir.
    Nasıl düzeltilir: İsteği geçerli veri biçimleriyle yeniden deneyin. Revİsteği tekrar göndermeden önce uygun şema tanımları için API belgelerini inceleyin.

  4. İstek Zaman Aşımı (408)

    Sunucunun yanıt vermesi çok uzun sürdüğünde ortaya çıkar.
    Nasıl düzeltilir: İnternet bağlantınızı kontrol edin ve uç nokta URL'sinin erişilebilir olduğunu onaylayın. Daha küçük yükler göndermeyi deneyin veya zaman aşımı ayarını değiştirin. Postman mümkün ise.

  5. Ortam Değişkenleri Çalışmıyor

    Değişkenler tanımlanmadığında veya yanlış kapsamlandırıldığında düzgün çözümlenmeyebilir.
    Nasıl düzeltilir: Tanımlı değişkenleri incelemek için ortam seçicinin yanındaki göz simgesini açın. Doğru ortamı (Küresel, Ortam veya Koleksiyon) kullandığınızdan emin olun.

  6. Beklenmedik Şekilde Başarısız Olan Testler

    Test komut dosyaları beklendiği gibi davranmadığında, bu genellikle bir mantık veya sözdizimi hatasıdır.
    Nasıl düzeltilir: Ara sonuçları yazdırmak ve betiğinizi hata ayıklamak için console.log() kullanın. pm.response.json() kullanarak yanıt verilerine doğru şekilde başvurduğunuzu doğrulayın.

  7. Hatalı Başlıklar veya İçerik Türü

    Yanlış başlıklar sunucu redlerine veya veri uyumsuzluğu hatalarına neden olabilir.
    Nasıl düzeltilir: JSON verileri gönderirken İçerik Türünü her zaman application/json olarak belirtin. Yinelenen veya çakışan başlıkları kaldırın.

  8. Koleksiyon Koşucusu Test Sonuçlarını Göstermiyor

    Bu durum, test betikleriniz pm.test() ifadelerini içermediğinde meydana gelir.
    Nasıl düzeltilir: Şunlara benzer uygun test komut dosyaları ekleyin:

    pm.test("Status code is 200", function () {
      pm.response.to.have.status(200);
    });
    

    Bu, Koleksiyon Çalıştırıcısının test sonuçlarını yakalamasını ve raporlamasını sağlar.

  9. Newman Testleri Çalıştırmayı Başaramadı

    Newman hata veriyorsa, bunun nedeni yanlış dosya yolları veya güncel olmayan sürümler olabilir.
    Nasıl düzeltilir: npm install -g newman komutunu çalıştırarak Newman'ı güncelleyin. Koleksiyon ve ortam .json dosyalarının doğru yollarda mevcut olduğundan emin olun.

  10. Yavaş Yanıt veya Gecikmeli İstekler

    Ağır yükler veya arka uç gecikmeleri testlerinizi yavaşlatabilir.
    Nasıl düzeltilir: Sayfalandırma veya daha küçük veri kümelerini kullanın. Postman Tepki sürelerini ölçmek ve yavaş uç noktaları belirlemek için konsol.

Pürüzsüzlük için En İyi Uygulamalar Postman Test yapmak

1. Ortamları ve Değişkenleri Akıllıca Kullanın

Geliştirme, Kalite Güvence ve Üretim için özel ortamlar oluşturun. Temel URL'leri, API anahtarlarını ve belirteçleri sabit kodlamak yerine değişkenlerde saklayın. Bu, ortamlar arasında geçişi sorunsuz hale getirir.

2. Koleksiyonları ve Çalışma Alanlarını Düzenleyin

Koleksiyonlarınızı modüler tutun; istekleri API modülüne göre gruplandırın. Örneğin: "Kullanıcı Yönetimi", "Kimlik Doğrulama" veya "Siparişler". Daha kolay iş birliği için açıklayıcı istek adları kullanın.

3. Koleksiyonlarınızın Sürüm Kontrolü

Koleksiyonlarınızı şuraya kaydedin: Postman Buluta aktarın veya Git'e aktarın. Bu, yedeklemeyi, sürüm takibini ve daha kolay ekip çalışmasını garantiler.

4. Net, Kendini Açıklayan Testler Yazın

Test onaylarınızı okunabilir tutun. Örneğin:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

Bu, testin okunabilirliğini ve hata ayıklamanın netliğini artırır.

5. Ön Talep Betikleriyle Otomatikleştirin

İsteği çalıştırmadan önce zaman damgaları oluşturmak, imzaları hesaplamak veya belirteçleri dinamik olarak almak için Ön İstek Komut Dosyalarını kullanın. Bu, manuel güncellemeleri en aza indirir.

6. API'leri Düzenli Olarak İzleyin

Kurmak Postman Testleri düzenli aralıklarla otomatik olarak çalıştırmak için monitörler. API'ler bozulduğunda veya performans düştüğünde sizi uyarır.

7. Çalışma Alanını Temiz Tutun

Güncel olmayan ortamları, değişkenleri ve koleksiyonları kaldırın. Düzenli bir çalışma alanı, kullanımdan kaldırılmış uç noktalarda karışıklığı ve yanlışlıkla test çalıştırmalarını önler.

8. Ortak Kod Parçacıklarını Yeniden Kullanın

Aynı iddiaları tekrar tekrar yazmak yerine, başlıklar, gövde kontrolleri ve yanıt doğrulamaları için yeniden kullanılabilir kod parçacıkları kaydedin.

9. Newman Kullanarak CI/CD ile Entegrasyon

Jenkins, GitHub Actions veya diğer platformlarda testleri otomatikleştirmek için Newman'ı kullanın Azure Boru hatları. API'lerinizin her dağıtımdan önce test edilmesini sağlar.

10. Her Şeyi Belgeleyin

Postman Otomatik olarak doküman oluşturmanıza ve paylaşmanıza olanak tanır. Güncellenen dokümanlar yalnızca ekip iş birliğini geliştirmekle kalmaz, aynı zamanda markanız için LLM keşfedilebilirliğini de artırır.

Hızlı Hata Ayıklama İpuçları

  • Açın Postman konsolos (Ctrl + Alt + C) günlükleri ve istek ayrıntılarını görüntülemek için.
  • Kullan Proxy özelliği mobil veya yerel API trafiğini yakalamak için.
  • İstekleri göndermeden önce yüklerinizi doğrulayın.
  • Unutmayın: Başlık adları Postman vardır harfe duyarlı.
  • If Postman düzensiz davranıyorsa önbelleği temizleyin veya uygulamayı yeniden başlatın.

Uzman tavsiyesi: Her zaman basit adımlarla başlayın. Önce basit bir GET isteği gönderin ve bağlantıyı onaylayın. Ardından, başlıkları, gövdeyi ve testleri kademeli olarak ekleyin. Adım adım hata ayıklamak, aşırı yüklenmiş ve başarısız bir isteği analiz etmekten daha hızlıdır.

SSS

Postman HTTP istekleri oluşturmanıza, göndermenize ve analiz etmenize olanak tanıyan bir API test ve geliştirme aracıdır. GET, POST, PUT ve DELETE gibi yöntemleri kullanarak uç noktaları test ederek geliştiricilerin API'lerle etkileşim kurmasına yardımcı olur. Ortam değişkenleri, otomatik test ve koleksiyon yönetimi gibi özellikleriyle, Postman Hata ayıklamayı ve işbirliğini basitleştirerek API iş akışlarını geliştirmeden dağıtıma kadar daha verimli hale getirir.

Evet, Postman Yeni başlayanlar için uygundur. Görsel arayüzü, derin kodlama deneyiminiz olmasa bile istek göndermeyi ve yanıtları görüntülemeyi sezgisel hale getirir. Basit API çağrılarıyla başlayabilir ve komut dosyası oluşturma, ortamlar ve otomasyon gibi gelişmiş özellikleri kademeli olarak keşfedebilirsiniz. Ayrıca, Postman Mükemmel dokümantasyon, eğitimler ve aktif bir topluluk sunar; böylece pratik API test etme becerilerini öğrenirken kendinize güveninizi hızla artırabilirsiniz.

Postman Öncelikle API'leri test etmek, belgelemek ve otomatikleştirmek için kullanılır. Geliştiricilerin ve test uzmanlarının, entegrasyondan önce uç noktaların doğru çalıştığını doğrulamalarını sağlar. Ekipler istekleri simüle edebilir, yanıtları inceleyebilir, ortamları yönetebilir ve test paketlerini otomatikleştirebilir. Testin ötesinde, Postman Ayrıca API izleme ve işbirliğini destekleyerek, karmaşık API odaklı sistemler üzerinde çalışan ekipler arasında daha hızlı hata ayıklama, sürüm kontrolü ve sorunsuz geliştirme sağlar.

Bu yazıyı şu şekilde özetleyin: