[Panduan] Skrip Permintaan POST Postman

Postman adalah alat populer untuk pengembangan dan pengujian antarmuka pemrograman aplikasi (API). Ini menyederhanakan proses pengiriman permintaan dan analisis respons, memungkinkan pengembang untuk membangun dan men-debug API secara efisien. Pembuatan skrip Postman memperluas fungsionalitas ini dengan memungkinkan otomatisasi tugas berulang dalam alur kerja pengujian.

Artikel ini membahas cara membuat skrip Post Request Postman, memandu Anda melalui proses pengiriman data, penanganan respons, dan pada akhirnya, meningkatkan efisiensi dan ketelitian pengujian API Anda.

Apa itu Skrip Post-Request Postman

Skrip post-request Postman pada dasarnya adalah program kecil yang ditulis dalam JavaScript yang dieksekusi setelah Postman mengirim permintaan dan menerima respons dari API.

Ini adalah alat yang tepat untuk pengembang yang bekerja dengan API (Application Programming Interfaces). Ini menyederhanakan pengiriman permintaan, analisis respons, dan pada akhirnya, membangun dan men-debug API.

Fungsi Inti Skrip Post-Request Postman

Validasi Respons

Verifikasi Kode Status: Skrip dapat memeriksa apakah API merespons dengan kode status yang diharapkan (mis., 200 untuk keberhasilan). Ini memastikan API berfungsi sebagaimana mestinya.

Asersi Data: Anda dapat menulis asersi untuk memvalidasi konten isi respons. Skrip dapat memeriksa nilai tertentu, dan struktur data (seperti objek JSON dengan kunci tertentu), atau memastikan tidak adanya data yang tidak terduga.

Manipulasi Data

Mengubah Data Respons: Skrip dapat memproses data yang diterima dalam respons. Ini dapat melibatkan pemformatan tanggal, konversi unit, atau ekstraksi informasi spesifik untuk digunakan lebih lanjut.

Mempersiapkan Data untuk Permintaan Berikutnya: Berdasarkan respons yang diterima, skrip dapat memodifikasi data yang dikirim dalam permintaan berikutnya. Ini memungkinkan skenario pengujian dinamis dan interaksi API yang dirantai.

Integrasi dengan Alat Eksternal

Mengirim Notifikasi: Skrip dapat memicu notifikasi berdasarkan hasil pengujian. Bayangkan mengirim pesan ke Slack jika pengujian API kritis gagal.

Mencatat Hasil: Pembuatan skrip memungkinkan pencatatan hasil pengujian ke database eksternal untuk analisis atau tujuan pelaporan lebih lanjut.

Lingkungan dan Objek Pembuatan Skrip

Eksekusi JavaScript: Postman menyediakan lingkungan "Sandbox" tempat skrip Anda berjalan dengan aman.

Mengakses Data Permintaan dan Respons: Objek pm menyediakan akses ke berbagai properti, dengan fokus pada pm.response untuk berinteraksi dengan data respons (isi, header, dll.).

Kasus Penggunaan Umum untuk Skrip Post-Request Postman

Validasi Respons Komprehensif

Memverifikasi Kode Status: Skrip dapat memastikan API merespons dengan kode status yang diharapkan untuk keberhasilan (200), kesalahan (400, 404), atau kode relevan lainnya.

Asersi Data Terperinci: Melampaui pemeriksaan sederhana. Skrip dapat memvalidasi struktur data kompleks dalam isi respons. Anda dapat menegaskan keberadaan atau tidak adanya kunci tertentu dalam objek JSON, memverifikasi format data (mis., tanggal, alamat email), atau memastikan nilai tertentu ada dalam struktur bertingkat.

Mengekstrak Data untuk Penggunaan Lebih Lanjut: Skrip dapat mengekstrak informasi berharga dari isi respons. Data ini kemudian dapat digunakan dalam permintaan berikutnya, disimpan untuk analisis nanti, atau diteruskan ke alat lain untuk pemrosesan lebih lanjut.

Manipulasi Data Tingkat Lanjut

Mengubah Data Respons: Skrip dapat memodifikasi data yang diterima dalam respons agar sesuai dengan kebutuhan pengujian Anda. Ini dapat melibatkan pemformatan stempel waktu, konversi mata uang, atau manipulasi tipe data (mis., konversi string menjadi angka).

Mempersiapkan Permintaan Dinamis: Berdasarkan respons dari satu panggilan API, skrip dapat secara dinamis memodifikasi data yang dikirim dalam permintaan berikutnya. Ini memungkinkan skenario pengujian yang dibangun di atas satu sama lain, mensimulasikan interaksi API dunia nyata.

Menghasilkan Data Uji: Skrip dapat secara dinamis menghasilkan data uji untuk panggilan API. Ini dapat berguna untuk menguji kasus ekstrem, membuat dataset besar, atau mengacak data untuk berbagai skenario.

Integrasi dengan Alat Eksternal untuk Pengujian yang Ditingkatkan

Mengirim Notifikasi: Bayangkan menerima notifikasi instan di Slack setiap kali pengujian API kritis gagal. Skrip dapat memicu notifikasi berdasarkan hasil pengujian, membuat tim Anda mendapat informasi tentang potensi masalah.

Mencatat Hasil Pengujian: Skrip dapat digunakan untuk mencatat hasil pengujian terperinci ke database eksternal. Ini memungkinkan pelaporan komprehensif, analisis historis kinerja pengujian, dan identifikasi tren dari waktu ke waktu.

Integrasi dengan Kerangka Kerja Pengujian: Skrip dapat menghubungkan Postman dengan kerangka kerja pengujian eksternal seperti Jest atau Mocha. Ini memungkinkan Anda untuk memanfaatkan alat pengujian yang ada dalam alur kerja Postman Anda untuk pendekatan pengujian yang lebih holistik.

Contoh Skrip Post-Request Postman

Mengakses Kode Status Respons dan Data Isi

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

console.log(pm.response.json());

Skrip ini melakukan dua tindakan:

• Ini menggunakan pm.test untuk menegaskan bahwa kode status respons adalah 200 (menunjukkan keberhasilan).
• Ini menggunakan pm.response.json() untuk mencetak seluruh konten isi respons ke konsol untuk diperiksa.

Membangun Asersi dengan pm.test

Fungsi pm.test Postman memungkinkan Anda untuk menulis asersi yang lebih kuat tentang data respons. Berikut adalah beberapa contoh:

Memeriksa Nilai Tertentu

pm.test("Name exists in response", function () {
  pm.expect(pm.response.json().name).to.equal("John Doe");
});

Memvalidasi Struktur Data

pm.test("Response has expected structure", function () {
  pm.expect(pm.response.json()).to.have.property("id");
  pm.expect(pm.response.json()).to.have.property("name");
});

Apidog - Alat Pengembangan API All-In-One

Apidog adalah alat API komprehensif yang menyediakan pengguna dengan fungsionalitas lengkap untuk seluruh siklus hidup API. Anda tidak perlu lagi mengunduh aplikasi tambahan!

Terapkan Skrip Pasca-Prosesor Anda Sendiri dengan Apidog

Dengan Apidog, Anda dapat mengimplementasikan pasca-prosesor dengan cara apa pun yang Anda inginkan.

Anda dapat memilih dari berbagai pasca-prosesor, seperti asersi, khusus, dan bahkan skrip publik.

Uji Beberapa API dengan Skenario Pengujian

Apidog memiliki fitur pengujian unik yang disebut skenario pengujian.

Dengan Apidog, Anda dapat secara visual menguji API yang berbeda bersama-sama dalam serangkaian langkah berurutan. Ini sangat efektif untuk pengembang yang telah membuat rantai API yang bergantung satu sama lain untuk melakukan fungsionalitasnya.

API Sempurna Dengan Laporan Akurat dan Terperinci

Apidog kemudian akan mengembalikan laporan terperinci tentang skenario pengujian Anda, menguraikan jumlah permintaan yang gagal dan berhasil, bersama dengan total durasi semua API untuk menyelesaikannya.

Kesimpulan

Skrip post-request Postman menawarkan alat yang ampuh dan serbaguna untuk meningkatkan proses pengujian API Anda. Dengan memanfaatkan skrip ini, Anda dapat mengotomatiskan tugas berulang, melakukan validasi data komprehensif, dan berintegrasi dengan alat eksternal untuk alur kerja yang lebih efisien. Apakah Anda seorang pengembang berpengalaman atau baru memulai dengan pengujian API, kemampuan pembuatan skrip Postman memberdayakan Anda untuk membangun API yang kuat dan andal dengan efisiensi yang lebih besar.

Ingat, dunia pembuatan skrip Postman menawarkan potensi eksplorasi yang luas. Mulailah dengan dasar-dasar yang diuraikan di sini, dan gali lebih dalam untuk membuka potensi penuh dari alat berharga ini untuk perjalanan pengembangan API Anda.