Postman Tutorial – Bagaimana cara menggunakannya untuk Pengujian API?

Apa itu Postman?

Postman adalah alat pengujian API skalabel yang terintegrasi dengan cepat ke dalam pipeline CI/CD. Ini dimulai 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 yang memungkinkan aplikasi perangkat lunak berkomunikasi satu sama lain melalui panggilan API.

Mengapa Menggunakan Postman?

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

Aksesibilitas – Untuk digunakan Postman alat ini, seseorang hanya perlu masuk ke akunnya sendiri sehingga memudahkan untuk mengakses file kapan saja, di mana saja selama a Postman aplikasi diinstal pada komputer.
Penggunaan Koleksi – Postman memungkinkan pengguna membuat koleksi untuk mereka Postman panggilan API. Setiap koleksi dapat membuat subfolder dan beberapa permintaan. Ini membantu dalam mengatur ruang pengujian Anda.
Kolaborasi – Koleksi dan lingkungan dapat diimpor atau diekspor sehingga memudahkan berbagi file. Tautan langsung juga dapat digunakan untuk berbagi koleksi.
Menciptakan Lingkungan – Memiliki beberapa lingkungan membantu mengurangi pengulangan pengujian karena seseorang dapat menggunakan koleksi yang sama tetapi untuk lingkungan yang berbeda. Di sinilah akan terjadi parameterisasi yang akan kita bahas pada pembelajaran selanjutnya.
Pembuatan Pengujian – Pos pemeriksaan pengujian seperti memverifikasi status respons HTTP yang berhasil dapat ditambahkan ke masing-masing pengujian Postman Panggilan API yang membantu memastikan cakupan tes.
Pengujian Otomasi – Melalui penggunaan Collection Runner atau Newman, pengujian dapat dijalankan dalam beberapa iterasi sehingga menghemat waktu untuk pengujian berulang.
Men-debug – Postman konsol membantu memeriksa data apa yang telah diambil sehingga memudahkan untuk melakukan debug pengujian.
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 Cara penggunaan Postman dan fitur yang berbeda dari Postman alat!

Baru – Di sinilah Anda akan membuat permintaan, koleksi, atau lingkungan baru.
Impor – Ini digunakan untuk mengimpor koleksi atau lingkungan. Ada opsi seperti impor dari file, folder, tautan, atau tempel teks mentah.
Runner – Tes otomatisasi dapat dijalankan melalui Collection Runner. Hal ini akan dibahas lebih lanjut pada pelajaran berikutnya.
Buka Baru – Buka tab baru, Postman Window atau Runner Window dengan mengklik tombol ini.
Ruang Kerja Saya – Anda dapat membuat ruang kerja baru secara individu atau sebagai tim.
Undang – Berkolaborasi di ruang kerja dengan mengundang anggota tim.
Riwayat – Permintaan sebelumnya yang telah Anda kirim akan ditampilkan di Riwayat. Ini memudahkan untuk melacak tindakan yang telah Anda lakukan.
Koleksi – Atur rangkaian pengujian Anda dengan membuat koleksi. Setiap koleksi mungkin memiliki subfolder dan beberapa permintaan. Permintaan atau folder juga dapat diduplikasi.
Tab Permintaan – Ini menampilkan judul permintaan yang sedang Anda kerjakan. Secara default, “Permintaan Tanpa Judul” akan ditampilkan untuk permintaan tanpa judul.
Permintaan HTTP – Mengklik ini akan menampilkan daftar dropdown permintaan yang berbeda seperti GET, POST, COPY, DELETE, dll. Postman Pengujian API, permintaan yang paling umum digunakan adalah GET dan POST.
URL Permintaan – Juga dikenal sebagai titik akhir, ini adalah tempat Anda mengidentifikasi tautan ke mana API akan berkomunikasi.
Simpan – Jika ada perubahan pada suatu permintaan, klik simpan adalah suatu keharusan agar perubahan baru tidak hilang atau tertimpa.
Params – Di sinilah Anda akan menulis parameter yang diperlukan untuk permintaan seperti nilai kunci.
Otorisasi – Untuk mengakses API, diperlukan otorisasi yang tepat. Bisa berupa username dan password, token pembawa, dll.
Header – Anda dapat mengatur header seperti tipe konten JSON tergantung pada kebutuhan organisasi.
Body – Di sinilah seseorang dapat menyesuaikan detail dalam permintaan yang umum digunakan dalam permintaan POST.
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.
Tes – Ini adalah skrip yang dijalankan selama permintaan. Penting untuk melakukan pengujian karena ini menyiapkan pos pemeriksaan untuk memverifikasi apakah status respons baik-baik saja, data yang diambil sesuai dengan yang diharapkan, dan pengujian lainnya.

Bekerja dengan Permintaan GET

Permintaan dapatkan 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

Setel permintaan HTTP Anda ke GET.
Di bidang URL permintaan, masukkan tautan
Klik Kirim
Anda akan melihat 200 Pesan OK
Seharusnya ada 10 hasil pengguna di badan yang menunjukkan bahwa pengujian Anda telah berhasil dijalankan.

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

Bekerja dengan Permintaan POST

Permintaan posting berbeda dari permintaan Dapatkan karena ada manipulasi data dengan pengguna menambahkan data ke titik akhir. Menggunakan data yang sama dari tutorial sebelumnya di Dapatkan permintaan, sekarang mari tambahkan pengguna kita sendiri.

Langkah 1) Klik tab baru untuk membuat permintaan baru.

Langkah 2) Di tab baru

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

Langkah 3) Di Tubuh,

Klik mentah
Pilih JSON

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": "Sincere@april.biz",
        "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"
        }
    }
]

* Catatan: Permintaan Posting Online harus memiliki format yang benar untuk memastikan bahwa data yang diminta akan dibuat. Merupakan praktik yang baik untuk menggunakan Dapatkan yang pertama untuk memeriksa format permintaan JSON. Anda dapat menggunakan alat seperti https://jsonformatter.curiousconcept.com/

Langkah 5) Selanjutnya,

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

Cara Membuat Parameter Permintaan

Parameterisasi Data adalah salah satu fitur yang paling berguna Postman. Daripada membuat permintaan yang sama dengan data berbeda, Anda bisa menggunakan variabel dengan parameter. Data ini bisa dari file data atau variabel lingkungan. Parameterisasi membantu menghindari pengulangan pengujian yang sama dan iterasi dapat digunakan pengujian otomasi.

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

Sekarang mari kita buat permintaan get parameterisasi.

Langkah 1)

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

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

Langkah 2) Untuk menggunakan parameter, Anda perlu mengatur lingkungan

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

Langkah 3) Dalam variabel,

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

Langkah 4) Klik tutup jika Anda melihat layar berikutnya

Langkah 5) Kembali ke permintaan Dapatkan Anda lalu klik kirim. Sekarang seharusnya ada hasil untuk permintaan Anda.

* Catatan: Selalu pastikan bahwa parameter Anda memiliki sumber seperti variabel lingkungan atau file 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, verify yang tersedia di alat lain.

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

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

Beralih ke tab tes. Di sisi kanan adalah kode cuplikan.
Dari bagian cuplikan, klik “Kode status: Kode adalah 200”.

Panel terisi secara otomatis

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

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.

Langkah 4)

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.
Ganti jsonData.value dengan jsonData[0].name. Untuk mendapatkan jalurnya, periksa isi di Dapatkan hasil tadi. Karena Leanne Graham adalah userid 1, jsonData ada di hasil pertama yang harus dimulai dengan 0. Jika ingin mendapatkan hasil kedua, gunakan jsonData[1] dan seterusnya untuk hasil berikutnya.
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");
});

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

* 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 mengatur ruang pengujian. Itu dapat diimpor dan diekspor sehingga memudahkan untuk berbagi koleksi di antara tim. Dalam tutorial ini, kita akan mempelajari cara membuat dan mengeksekusi koleksi.

Mari kita mulai membuat koleksi:

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

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

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

Langkah 4) Kembali ke permintaan Dapatkan sebelumnya. Klik Simpan

Langkah 5)

Pilih Postman Koleksi Tes.
Klik Simpan untuk Postman Koleksi Tes

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

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

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.

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

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

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

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

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:

Newman adalah tambahan untuk Postman. Anda harus menginstalnya secara terpisah dari Aplikasi Asli.
Newman menggunakan baris perintah sementara Collection Runner memiliki GUI.
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.

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

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

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.

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.

Untuk panduannya adalah referensi ke beberapa kode dasar Newman untuk dieksekusi:

Jalankan koleksi saja. Ini dapat digunakan jika tidak ada ketergantungan lingkungan atau file data pengujian.

newman run <collection name>

Jalankan koleksi dan lingkungan. Indikator -e untuk lingkungan.

newman run <collection name> -e <environment name>

Jalankan koleksi dengan no yang diinginkan. dari iterasi.

newman run <collection name> -n <no.of iterations>

Jalankan dengan file data.

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>

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.

newman run <collection name> -d <delay time>

Mitra Postman panduan pertanyaan wawancara akan membantu Anda menyelesaikan wawancara dan membantu Anda mendapatkan pekerjaan impian Anda untuk pengujian perangkat lunak.

Kesimpulan

Pengujian API menggunakan Postman: Postman adalah aplikasi untuk menguji API. Postman adalah salah satu alat paling populer yang digunakan dalam pengujian API dengan mengirimkan permintaan ke server web dan mendapatkan responsnya kembali
Aksesibilitas, Penggunaan Koleksi, Kolaborasi, Integrasi Berkelanjutan, adalah beberapa fitur utama untuk dipelajari Postman
Anda disarankan untuk membuat akun di Postman, sehingga koleksi Anda tersedia online
Anda dapat membuat parameter permintaan Postman
Anda dapat membuat Tes untuk memverifikasi permintaan tukang pos
Koleksi dapat dijalankan menggunakan Newman atau Collection Runner

Anda mungkin ingin: