Postman Tutorial

๐Ÿš€ Ringkasan Cerdas

Postman adalah alat pengujian API yang skalabel dan dirancang untuk manajemen alur kerja API yang efisien dalam lingkungan pengembangan dan pengujian. Alat ini memungkinkan pengorganisasian, kolaborasi, dan otomatisasi yang efisien, menjadikan tugas-tugas pengujian API yang penting mudah diakses dan diulang.

  • Prinsip Utama: Postman menyediakan ruang kerja terpadu untuk pembuatan, pengujian, dan pengelolaan permintaan API, yang mendukung alur kerja pengujian manual dan otomatis.
  • Fokus Implementasi: Atur permintaan ke dalam koleksi, yang selanjutnya dapat dibagi lagi ke dalam folder dan dibagikan dengan mudah di antara anggota tim untuk kolaborasi yang efisien.
  • Aturan Parameterisasi: Gunakan variabel lingkungan dan global dengan tanda kurung kurawal ganda (misalnya, {{url}}) untuk membuat parameterisasi permintaan, mengurangi redundansi dan memungkinkan penggunaan kembali di beberapa titik akhir API.
  • Dasar-dasar Pengujian: Menulis JavaPengujian berbasis skrip di tab Pengujian untuk memvalidasi kode status, isi respons, dan nilai yang diharapkan, memastikan cakupan dan keandalan API yang kuat.
  • Jalur Otomatisasi: Jalankan koleksi melalui Collection Runner atau Newman, yang terakhir penting untuk integrasi CI/CD dan eksekusi batch otomatis menggunakan antarmuka baris perintah.

Postman Tutorial

Apa itu Postman?

Postman adalah alat pengujian API yang skalabel dan terintegrasi dengan cepat ke dalam alur kerja CI/CD. Berawal pada tahun 2012 sebagai proyek sampingan oleh Abhinav Asthana untuk menyederhanakan alur kerja API dalam pengujian dan pengembangan. API adalah singkatan dari Application Programming Interface (Antarmuka Pemrograman Aplikasi), yang memungkinkan aplikasi perangkat lunak berkomunikasi satu sama lain melalui panggilan API.

๐Ÿ‘‰ Daftar untuk Proyek Pengujian API Langsung Gratis

Mengapa Menggunakan Postman?

Dengan lebih dari 4 juta pengguna saat ini, Postman Perangkat lunak telah menjadi alat pilihan karena alasan berikut:

  1. Aksesibilitas โ€“ Untuk menggunakan Postman alat ini, seseorang hanya perlu masuk ke akun mereka sendiri, sehingga memudahkan akses file kapan saja, di mana saja, selama Postman aplikasi diinstal pada komputer.
  2. Penggunaan Koleksi โ€“ Postman memungkinkan pengguna membuat koleksi untuk mereka Postman Panggilan API. Setiap koleksi dapat membuat subfolder dan beberapa permintaan. Ini membantu dalam mengelola rangkaian pengujian Anda.
  3. Kolaborasi โ€“ Koleksi dan lingkungan dapat diimpor atau diekspor, sehingga memudahkan berbagi berkas. Tautan langsung juga dapat digunakan untuk berbagi koleksi.
  4. Membuat Lingkungan โ€“ Memiliki beberapa lingkungan membantu mengurangi pengulangan pengujian, karena seseorang dapat menggunakan koleksi yang sama tetapi untuk lingkungan yang berbeda. Di sinilah parameterisasi akan dilakukan, yang akan kita bahas di pelajaran selanjutnya.
  5. Pembuatan Pengujian โ€“ Titik pemeriksaan pengujian, seperti memverifikasi status respons HTTP yang berhasil, dapat ditambahkan ke setiap Postman Panggilan API, yang membantu memastikan cakupan tes.
  6. Pengujian Otomatisasi โ€“ Melalui penggunaan Collection Runner atau Newman, pengujian dapat dijalankan dalam beberapa iterasi, menghemat waktu untuk pengujian berulang.
  7. Men-debug โ€“ Postman konsol membantu memeriksa data apa yang telah diambil, sehingga memudahkan untuk men-debug pengujian.
  8. Integrasi berkelanjutan โ€“ Dengan kemampuannya mendukung integrasi berkelanjutan, praktik pembangunan tetap terjaga.

Cara penggunaan Postman untuk mengeksekusi API

Di bawah ini adalah Postman Ruang kerja. Mari kita jelajahi proses langkah demi langkah di Cara penggunaan Postman dan fitur yang berbeda dari Postman alat!

Cara Menggunakan Postman Untuk Mengeksekusi API

  1. Baru โ€“ Di sinilah Anda akan membuat permintaan, koleksi, atau lingkungan baru.
  2. Impor โ€“ Digunakan untuk mengimpor koleksi atau lingkungan. Tersedia opsi seperti impor dari berkas, folder, tautan, atau tempel teks mentah.
  3. Runner โ€“ Tes otomatisasi dapat dijalankan melalui Collection Runner. Hal ini akan dibahas lebih lanjut pada pelajaran berikutnya.
  4. Buka Baru โ€“ Buka tab baru, Postman Jendela, atau Jendela Pelari dengan mengklik tombol ini.
  5. Ruang Kerja Saya โ€“ Anda dapat membuat ruang kerja baru secara individu atau sebagai tim.
  6. Undang โ€“ Berkolaborasi di ruang kerja dengan mengundang anggota tim.
  7. Riwayat โ€“ Permintaan sebelumnya yang telah Anda kirim akan ditampilkan di Riwayat. Ini memudahkan untuk melacak tindakan yang telah Anda lakukan.
  8. Koleksi โ€“ Atur rangkaian pengujian Anda dengan membuat koleksi. Setiap koleksi dapat memiliki subfolder dan beberapa permintaan. Permintaan atau folder juga dapat diduplikasi.
  9. Tab Permintaan โ€“ Ini menampilkan judul permintaan yang sedang Anda kerjakan. Secara default, โ€œPermintaan Tanpa Judulโ€ akan ditampilkan untuk permintaan tanpa judul.
  10. Permintaan HTTP โ€“ Mengklik ini akan menampilkan daftar dropdown dari berbagai permintaan, seperti GET, POST, COPY, DELETE, dll. Di Postman Pengujian API, permintaan yang paling umum digunakan adalah GET dan POST.
  11. URL Permintaan โ€“ Juga dikenal sebagai titik akhir, di sinilah Anda akan mengidentifikasi tautan yang akan dikomunikasikan oleh API.
  12. Simpan โ€“ Jika ada perubahan pada suatu permintaan, klik simpan adalah suatu keharusan agar perubahan baru tidak hilang atau tertimpa.
  13. Params โ€“ Di sinilah Anda akan menulis parameter yang diperlukan untuk permintaan, seperti nilai kunci.
  14. Otorisasi โ€“ Untuk mengakses API, diperlukan otorisasi yang tepat. Otorisasi dapat berupa nama pengguna dan kata sandi, token pembawa, dll.
  15. Header โ€“ Anda dapat mengatur header seperti jenis konten JSON, tergantung pada kebutuhan organisasi.
  16. Body โ€“ Di sinilah seseorang dapat menyesuaikan detail dalam permintaan, umumnya digunakan dalam permintaan POST.
  17. Skrip Pra-Permintaan โ€“ Ini adalah skrip yang akan dieksekusi sebelum permintaan. Biasanya, skrip pra-permintaan untuk lingkungan pengaturan digunakan untuk memastikan bahwa pengujian akan dijalankan di lingkungan yang benar.
  18. Pengujian โ€“ Ini adalah skrip yang dijalankan selama permintaan. Pengujian penting karena akan menyiapkan titik pemeriksaan untuk memverifikasi apakah status respons baik, data yang diambil sesuai harapan, dan pengujian lainnya.

Bekerja dengan Permintaan GET

Permintaan "Get" digunakan untuk mengambil informasi dari URL yang diberikan. Tidak akan ada perubahan yang dilakukan pada titik akhir.

Kami akan menggunakan URL berikut untuk semua contoh di sini Postman tutorial https://jsonplaceholder.typicode.com/users

Di ruang kerja

  1. Setel permintaan HTTP Anda ke GET.
  2. Di kolom URL permintaan, masukkan tautannya
  3. Klik Kirim
  4. Anda akan melihat Pesan โ€œ200 OKโ€
  5. Seharusnya ada 10 hasil pengguna di badan, yang menunjukkan bahwa pengujian Anda telah berjalan dengan sukses.

Bekerja dengan Dapatkan Permintaan

* Catatan: Mungkin ada kasus di mana Dapatkan Postman Permintaan mungkin tidak berhasil. Hal ini dapat disebabkan oleh URL permintaan yang tidak valid, atau autentikasi diperlukan.

Bekerja dengan Permintaan POST

Permintaan Post berbeda dengan permintaan Get karena terdapat manipulasi data dengan menambahkan data ke titik akhir oleh pengguna. Dengan menggunakan data yang sama dari tutorial sebelumnya di permintaan Get, sekarang mari kita tambahkan pengguna kita sendiri.

Langkah 1) Klik tab baru untuk membuat permintaan baru.

Bekerja Dengan Permintaan Posting

Langkah 2) Di tab baru

  1. Setel permintaan HTTP Anda ke POST.
  2. Masukkan tautan yang sama di url permintaan: https://jsonplaceholder.typicode.com/users
  3. beralih ke tab Isi

Bekerja Dengan Permintaan Posting

Langkah 3) Di Tubuh,

  1. Klik mentah
  2. Pilih JSON

Bekerja Dengan Permintaan Posting

Langkah 4) Salin dan tempel hanya satu hasil pengguna dari permintaan get sebelumnya seperti di bawah ini. Pastikan kode telah disalin dengan benar dengan kurung kurawal dan tanda kurung siku berpasangan. Ubah id menjadi 11 dan nama menjadi nama yang diinginkan. Anda juga dapat mengubah detail lain seperti alamat.

[
    {
        "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"
        }
    }
]

Bekerja Dengan Permintaan Posting

* Catatan: Permintaan Posting Online harus memiliki format yang tepat untuk memastikan data yang diminta akan dibuat. Sebaiknya gunakan Get terlebih dahulu untuk memeriksa format JSON permintaan. Anda dapat menggunakan alat seperti https://jsonformatter.curiousconcept.com/

Bekerja Dengan Permintaan Posting

Langkah 5) Selanjutnya,

  1. Klik Kirim.
  2. Status: 201 Dibuat harus ditampilkan
  3. Data yang diposting akan ditampilkan di badan.

Bekerja Dengan Permintaan Posting

Cara Membuat Parameter Permintaan

Parameterisasi Data adalah salah satu fitur yang paling berguna PostmanAlih-alih membuat permintaan yang sama dengan data yang berbeda, Anda dapat menggunakan variabel dengan parameter. Data ini dapat berasal dari berkas data atau variabel lingkungan. Parameterisasi membantu menghindari pengulangan pengujian yang sama, dan iterasi dapat digunakan untuk pengujian otomasi.

Parameter dibuat melalui penggunaan tanda kurung kurawal ganda: {{sample}}. Mari kita lihat contoh penggunaan parameter dalam permintaan kita sebelumnya:

Parameterisasi Permintaan

Sekarang mari kita membuat permintaan GET yang berparameter.

Langkah 1)

  1. Setel permintaan HTTP Anda ke GET
  2. Masukkan tautan ini: https://jsonplaceholder.typicode.com/users. Ganti bagian pertama tautan dengan parameter seperti {{url}}. Url permintaan sekarang seharusnya menjadi {{url}}/pengguna.
  3. Klik kirim.

Seharusnya tidak ada respon karena kita belum menyetel sumber parameter kita.

Parameterisasi Permintaan

Langkah 2) Untuk menggunakan parameter, Anda perlu mengatur lingkungan

  1. Klik ikon mata
  2. Klik edit untuk mengatur variabel ke lingkungan global, yang dapat digunakan di semua koleksi.

Parameterisasi Permintaan

Langkah 3) Dalam variabel,

  1. atur nama ke url yaitu https://jsonplaceholder.typicode.com
  2. klik Simpan.

Parameterisasi Permintaan

Langkah 4) Klik tutup jika Anda melihat layar berikutnya

Parameterisasi Permintaan

Langkah 5) Kembali ke permintaan "Get" Anda, lalu klik "Kirim". Sekarang seharusnya sudah ada hasil untuk permintaan Anda.

Parameterisasi Permintaan

* Catatan: Selalu pastikan bahwa parameter Anda memiliki sumber, seperti variabel lingkungan atau berkas data, untuk menghindari kesalahan.

Cara Membuat Postman Tes

Postman Tes adalah JavaKode skrip ditambahkan ke permintaan yang membantu Anda memverifikasi hasil, seperti status berhasil atau gagal, perbandingan hasil yang diharapkan, dll. Biasanya dimulai dengan pm.test. Ini dapat dibandingkan dengan perintah asserts dan verify yang tersedia di alat lain.

Mari kita lakukan hal mendasar Pengujian API menggunakan Postman untuk permintaan berparameter kita dari pelajaran sebelumnya.

Langkah 1) Buka permintaan pengguna GET Anda dari tutorial sebelumnya.

  1. Beralih ke tab tes. Di sisi kanan adalah kode cuplikan.
  2. Dari bagian cuplikan, klik โ€œKode status: Kode adalah 200โ€.

Panel terisi secara otomatis

membuat Postman Tes

Langkah 2) Sekarang klik Kirim. Hasil tes akan ditampilkan sekarang.

membuat Postman Tes

Langkah 3) Kembali ke tab tes dan tambahkan tes lainnya. Kali ini kita akan membandingkan hasil yang diharapkan dengan hasil sebenarnya.

Dari bagian cuplikan, klik โ€œBadan respons: Pemeriksaan nilai JSONโ€. Kami akan memeriksa apakah Leanne Graham memiliki userid 1.

membuat Postman Tes

Langkah 4)

  1. Ganti โ€œNama Tes Andaโ€ dari kode dengan โ€œPeriksa apakah pengguna dengan id1 adalah Leanne Grahamโ€ sehingga nama tes menentukan dengan tepat apa yang ingin kita uji.
  2. Ganti jsonData.value dengan jsonData[0].name. Untuk mendapatkan path, periksa isi di Dapatkan hasil sebelumnya. Karena Leanne Graham adalah userid 1, jsonData ada di hasil pertama, yang seharusnya dimulai dengan 0. Jika Anda ingin mendapatkan hasil kedua, gunakan jsonData[1] dan seterusnya untuk hasil selanjutnya.
  3. Ke persamaan, masukkan โ€œLeanne Grahamโ€
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");
});

membuat Postman Tes

Langkah 5) Klik kirim. Sekarang seharusnya ada dua hasil tes yang lulus untuk permintaan Anda.

membuat Postman Tes

* Catatan: Ada berbagai jenis tes yang dapat dibuat Postman. Cobalah untuk menjelajahi alat ini dan lihat tes apa yang sesuai dengan kebutuhan Anda.

Cara Membuat Koleksi

Koleksi memainkan peran penting dalam mengelola rangkaian pengujian. Koleksi dapat diimpor dan diekspor, sehingga memudahkan berbagi koleksi di antara tim. Dalam tutorial ini, kita akan mempelajari cara membuat dan menjalankan koleksi.

Mari kita mulai membuat koleksi:

Langkah 1) Klik tombol Baru di sudut kiri atas halaman.

Buat Koleksi

Langkah 2) Pilih Koleksi. Jendela Buat Koleksi akan muncul.

Buat Koleksi

Langkah 3) Masukkan nama koleksi dan deskripsi yang diinginkan lalu klik buat. Koleksi sekarang harus dibuat.

Buat Koleksi

Langkah 4) Kembali ke permintaan Dapatkan sebelumnya. Klik Simpan

Buat Koleksi

Langkah 5)

  1. Pilih Postman Koleksi Tes.
  2. Klik Simpan untuk Postman Koleksi Tes

Buat Koleksi

Langkah 6) Postman koleksi tes sekarang harus berisi satu permintaan.

Buat Koleksi

Langkah 7) Ulangi langkah 4-5 untuk permintaan Post sebelumnya sehingga koleksi sekarang akan memiliki dua permintaan.

Buat Koleksi

Cara Menjalankan Koleksi menggunakan Collection Runner

Ada dua cara menjalankan koleksi yaitu Collection Runner dan Newman. Mari kita mulai dengan mengeksekusi koleksi di Collection Runner.

Langkah 1) Klik tombol Pelari yang terdapat di bagian atas halaman di sebelah tombol Impor.

Jalankan Koleksi Menggunakan Collection Runner

Langkah 2) Halaman Collection Runner akan muncul seperti di bawah ini. Berikut ini adalah deskripsi berbagai bidang

Jalankan Koleksi Menggunakan Collection Runner

Langkah 3) Jalankan Anda Postman Pengumpulan Tes dengan menyiapkan hal berikut:

  • Pilih Postman koleksi tes- Tetapkan iterasi sebagai 3
  • Tetapkan penundaan sebagai 2500 ms
  • Klik Jalankan Postman Ujiโ€ฆ tombol

Jalankan Koleksi Menggunakan Collection Runner

Langkah 4) Halaman Hasil Eksekusi akan ditampilkan setelah mengklik tombol Eksekusi. Bergantung pada penundaan, Anda akan melihat pengujian saat dijalankan.

  1. Setelah pengujian selesai, Anda dapat melihat status pengujian apakah Lulus atau Gagal dan hasilnya per iterasi.
  2. Anda melihat status Lulus untuk Dapatkan Permintaan
  3. Karena kami tidak memiliki tes apa pun untuk Post, seharusnya ada pesan bahwa permintaan tersebut tidak memiliki tes apa pun.

Jalankan Koleksi Menggunakan Collection Runner

Anda dapat melihat betapa pentingnya adanya pengujian dalam permintaan Anda sehingga Anda dapat memverifikasi status permintaan HTTP jika berhasil dan data dibuat atau diambil.

Cara Menjalankan Koleksi menggunakan Newman

Cara lain untuk menjalankan koleksi adalah melalui Newman. Perbedaan utama antara Newman dan Collection Runner adalah sebagai berikut:

  1. Newman adalah tambahan untuk Postman. Anda harus menginstalnya secara terpisah dari Aplikasi Asli.
  2. Newman menggunakan baris perintah sementara Collection Runner memiliki GUI.
  3. Newman dapat digunakan untuk integrasi berkelanjutan.

Untuk menginstal Newman dan menjalankan koleksi kita dari sana, lakukan hal berikut:

Langkah 1) Instal nodejs menggunakan tautan ini: http://nodejs.org/download/

Langkah 2) Buka baris perintah dan enter

 npm install -g newman

Newman sekarang harus diinstal di komputer Anda.

Jalankan Koleksi Menggunakan Newman

Langkah 3) Setelah Newman terinstal, mari kembali ke Postman ruang kerja. Di kotak Koleksi, klik tiga titik. Opsi sekarang akan muncul. Pilih Ekspor.

Jalankan Koleksi Menggunakan Newman

Langkah 4) Pilih Ekspor Koleksi sebagai Koleksi v2.1 (Disarankan) lalu klik Ekspor.

Jalankan Koleksi Menggunakan Newman

Langkah 5) Pilih lokasi yang Anda inginkan lalu klik Simpan. Dianjurkan untuk membuat folder khusus untuk Anda Postman tes. Koleksi sekarang harus diekspor ke direktori lokal pilihan Anda.

Langkah 6) Kita juga perlu mengekspor lingkungan kita. Klik ikon mata di samping dropdown lingkungan di Global, pilih Unduh sebagai JSON. Pilih lokasi yang Anda inginkan lalu klik Simpan. Disarankan agar lingkungan berada di folder yang sama dengan koleksi Anda.

Jalankan Koleksi Menggunakan Newman

Langkah 7) Lingkungan sekarang harus diekspor ke direktori lokal yang sama dengan Koleksi.

Langkah 8) Sekarang kembali ke baris perintah dan ubah direktori ke tempat Anda menyimpan koleksi dan lingkungan.

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

Langkah 9) Jalankan koleksi Anda menggunakan perintah ini:

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

Hasil run sekarang akan muncul seperti di bawah ini.

Jalankan Koleksi Menggunakan Newman

Untuk panduan ini adalah referensi ke beberapa kode Newman dasar untuk eksekusi:

  1. Jalankan koleksi saja. Ini dapat digunakan jika tidak ada ketergantungan lingkungan atau file data pengujian.
  2. newman run <collection name>
  3. Jalankan koleksi dan lingkungan. Indikator -e untuk lingkungan.
  4. newman run <collection name> -e <environment name>
  5. Jalankan koleksi dengan no yang diinginkan. dari iterasi.
  6. newman run <collection name> -n <no.of iterations>
  7. Jalankan dengan file data.
  8. newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>
  9. Setel waktu tunda. Hal ini penting karena pengujian mungkin gagal jika dijalankan tanpa penundaan karena permintaan dimulai tanpa permintaan sebelumnya menyelesaikan pemrosesan di server titik akhir.
  10. newman run <collection name> -d <delay time>

Mitra Postman panduan pertanyaan wawancara akan membantu Anda lolos wawancara dan membantu Anda mendapatkan pekerjaan impian di bidang pengujian perangkat lunak.

Umum Postman Skenario Pemecahan Masalah

  1. 401 Kesalahan Tidak Sah atau 403 Kesalahan Terlarang

    Hal ini terjadi apabila permintaan Anda tidak memiliki kredensial autentikasi yang valid.
    Bagaimana cara memperbaiki: DoublePeriksa jenis Otorisasi Anda (Kunci API, Token Pembawa, atau Otorisasi Dasar). Jika Anda menggunakan token, pastikan token tersebut masih berlaku. Buat token baru atau perbarui kredensial sesi jika diperlukan.

  2. 400 Bad Request

    Anda akan mendapatkan kesalahan ini ketika sintaksis atau parameter permintaan salah.
    Bagaimana cara memperbaiki: Validasi isi JSON atau XML Anda menggunakan pemformat seperti JSONLint. Pastikan parameter Anda sesuai dengan yang diharapkan API, termasuk sensitivitas huruf besar-kecil dan tipe data.

  3. 500 Internal Error Server

    Ini biasanya merupakan masalah backend tetapi dapat juga terjadi ketika muatan Anda tidak terstruktur dengan benar.
    Bagaimana cara memperbaiki: Coba lagi permintaan dengan format data yang valid. RevLihat dokumentasi API untuk definisi skema yang tepat sebelum mengirim permintaan lagi.

  4. Permintaan Batas Waktu (408)

    Terjadi ketika server membutuhkan waktu terlalu lama untuk merespons.
    Bagaimana cara memperbaiki: Periksa koneksi internet Anda dan pastikan URL titik akhir dapat diakses. Coba kirim muatan yang lebih kecil atau sesuaikan pengaturan batas waktu di Postman jika tersedia.

  5. Variabel Lingkungan Tidak Berfungsi

    Variabel mungkin tidak teratasi dengan baik apabila tidak didefinisikan atau cakupannya tidak tepat.
    Bagaimana cara memperbaiki: Buka ikon mata di samping pemilih lingkungan untuk meninjau variabel yang telah ditentukan. Pastikan Anda menggunakan lingkungan yang tepat (Global, Lingkungan, atau Koleksi).

  6. Tes Gagal Tiba-tiba

    Bila skrip pengujian tidak berfungsi seperti yang diharapkan, sering kali terjadi kesalahan logika atau sintaksis.
    Bagaimana cara memperbaiki: Gunakan console.log() untuk mencetak hasil sementara dan men-debug skrip Anda. Pastikan Anda mereferensikan data respons dengan benar menggunakan pm.response.json().

  7. Header atau Jenis Konten Salah

    Header yang salah dapat menyebabkan penolakan server atau kesalahan ketidakcocokan data.
    Bagaimana cara memperbaiki: Selalu tentukan Tipe Konten sebagai application/json saat mengirim data JSON. Hapus header duplikat atau yang bertentangan.

  8. Pengumpulan Hasil Tes Tidak Ditunjukkan

    Ini terjadi ketika skrip pengujian Anda tidak berisi pernyataan pm.test()
    Bagaimana cara memperbaiki: Tambahkan skrip pengujian yang tepat seperti:

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

    Hal ini memastikan Collection Runner menangkap dan melaporkan hasil pengujian.

  9. Newman Gagal Menjalankan Tes

    Jika Newman memunculkan kesalahan, hal itu bisa jadi disebabkan oleh jalur berkas yang salah atau versi yang sudah ketinggalan zaman.
    Bagaimana cara memperbaiki: Perbarui Newman dengan menjalankan npm install -g newman. Periksa apakah berkas .json koleksi dan lingkungan berada di jalur yang benar.

  10. Respons Lambat atau Permintaan Tertunda

    Muatan yang berat atau penundaan backend dapat memperlambat pengujian Anda.
    Bagaimana cara memperbaiki: Gunakan paginasi atau set data yang lebih kecil. Aktifkan Postman Konsol untuk mengukur waktu respons dan mengidentifikasi titik akhir yang lambat.

Praktik Terbaik untuk Kelancaran Postman pengujian

1. Gunakan Lingkungan dan Variabel dengan Cerdas

Buat lingkungan khusus untuk Pengembangan, QA, dan Produksi. Simpan URL dasar, kunci API, dan token dalam variabel, alih-alih melakukan hardcode. Hal ini membuat perpindahan antar lingkungan menjadi mudah.

2. Atur Koleksi dan Ruang Kerja

Jaga koleksi Anda tetap modularโ€”kelompokkan permintaan berdasarkan modul API. Misalnya: "Manajemen Pengguna", "Autentikasi", atau "Pesanan". Gunakan nama permintaan yang deskriptif untuk memudahkan kolaborasi.

3. Kontrol Versi Koleksi Anda

Simpan koleksi Anda di Postman Cloud atau ekspor ke Git. Ini memastikan pencadangan, pelacakan versi, dan kerja tim yang lebih mudah.

4. Tulis Tes yang Jelas dan Dapat Menjelaskan Diri Sendiri

Pastikan pernyataan pengujian Anda mudah dibaca. Misalnya:

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

Ini meningkatkan keterbacaan pengujian dan kejelasan debugging.

5. Otomatiskan dengan Skrip Pra-Permintaan

Gunakan Skrip Pra-Permintaan untuk menghasilkan stempel waktu, menghitung tanda tangan, atau mengambil token secara dinamis sebelum menjalankan permintaan. Ini meminimalkan pembaruan manual.

6. Pantau API secara berkala

Mendirikan Postman Monitor untuk menjalankan pengujian secara otomatis secara berkala. Monitor ini memberi tahu Anda ketika API rusak atau kinerja menurun.

7. Jaga Kebersihan Tempat Kerja

Hapus lingkungan, variabel, dan koleksi yang usang. Ruang kerja yang rapi mencegah kebingungan dan pengujian yang tidak disengaja pada titik akhir yang usang.

8. Gunakan Kembali Cuplikan Kode Umum

Daripada menulis pernyataan yang sama berulang kali, simpan potongan kode yang dapat digunakan kembali untuk tajuk, pemeriksaan isi, dan validasi respons.

9. Integrasikan dengan CI/CD Menggunakan Newman

Gunakan Newman untuk mengotomatiskan pengujian di Jenkins, GitHub Actions, atau Azure Pipeline. Ini memastikan API Anda diuji sebelum setiap penerapan.

10. Dokumentasikan Semuanya

Postman Memungkinkan Anda membuat dan membagikan dokumentasi secara otomatis. Dokumen yang diperbarui tidak hanya meningkatkan kolaborasi tim, tetapi juga meningkatkan kemampuan LLM untuk menemukan merek Anda.

Tips Debugging Cepat

  • Buka Postman konsul (Ctrl + Alt + C) untuk melihat log dan detail permintaan.
  • Gunakan Fitur proksi untuk menangkap lalu lintas API seluler atau lokal.
  • Validasi muatan Anda sebelum mengirim permintaan.
  • Ingat: nama header di Postman adalah hal - hal sensitif.
  • If Postman berperilaku tidak menentu, bersihkan cache atau mulai ulang aplikasi.

Saran Ahli: Selalu mulai dengan sederhana. Kirim permintaan GET dasar terlebih dahulu dan konfirmasi konektivitas. Kemudian, tambahkan header, isi, dan pengujian secara bertahap. Men-debug langkah demi langkah lebih cepat daripada menganalisis permintaan yang kelebihan beban dan gagal.

Pertanyaan Umum (FAQ)

Postman adalah alat pengujian dan pengembangan API yang memungkinkan Anda membuat, mengirim, dan menganalisis permintaan HTTP. Alat ini membantu developer berinteraksi dengan API dengan menguji titik akhir menggunakan metode seperti GET, POST, PUT, dan DELETE. Dengan fitur-fitur seperti variabel lingkungan, pengujian otomatis, dan manajemen koleksi, Postman menyederhanakan penelusuran kesalahan dan kolaborasi, membuat alur kerja API lebih efisien dari pengembangan hingga penerapan.

Ya, Postman Ramah bagi pemula. Antarmuka visualnya membuat pengiriman permintaan dan melihat respons menjadi intuitif, bahkan tanpa pengalaman coding yang mendalam. Anda dapat memulai dengan panggilan API sederhana dan secara bertahap menjelajahi fitur-fitur canggih seperti skrip, lingkungan, dan otomatisasi. Selain itu, Postman menawarkan dokumentasi, tutorial, dan komunitas yang aktif dan sangat baikโ€”sehingga Anda dapat dengan cepat membangun kepercayaan diri sambil mempelajari keterampilan pengujian API praktis.

Postman terutama digunakan untuk menguji, mendokumentasikan, dan mengotomatiskan API. Hal ini memungkinkan pengembang dan penguji untuk memverifikasi bahwa titik akhir berfungsi dengan benar sebelum integrasi. Tim dapat mensimulasikan permintaan, memeriksa respons, mengelola lingkungan, dan mengotomatiskan rangkaian pengujian. Selain pengujian, Postman juga mendukung pemantauan dan kolaborasi API, memungkinkan penelusuran kesalahan yang lebih cepat, kontrol versi, dan pengembangan yang lebih efisien di seluruh tim yang bekerja pada sistem berbasis API yang kompleks.

Ringkaslah postingan ini dengan: