Postman API Testing Tutorial: Panduan & Langkah Praktis 2026

Postman adalah aplikasi kolaborasi berbasis desktop dan web yang digunakan untuk membuat, menguji, dan mendokumentasikan API (Application Programming Interface). Tutorial ini menyajikan panduan teknis esensial mulai dari instalasi, pengiriman request HTTP pertama, hingga pembuatan environment variables dan penulisan test scripts dasar untuk validasi respons server.

Sebelum melakukan pengujian, pastikan Anda telah mengunduh aplikasi resmi Postman dari situs web pengembang atau menggunakan versi web di browser melalui postman.com. Platform ini mendukung pengujian berbagai jenis metode HTTP seperti GET, POST, PUT, DELETE, PATCH, dan OPTIONS.

Matriks Metode HTTP dan Fungsi Utama di Postman

Metode HTTP Fungsi Utama Penggunaan Umum dalam API Testing
GET Mengambil data dari server Mendapatkan daftar pengguna atau detail produk
POST Mengirim data baru ke server Membuat akun pengguna baru atau entri data baru
PUT Memperbarui seluruh data yang ada Mengubah seluruh atribut profil pengguna
PATCH Memperbarui sebagian data Mengubah kata sandi atau status aktif akun
DELETE Menghapus data dari server Menghapus data transaksi atau akun pengguna

Langkah-Langkah Pengujian API di Postman

Ikuti prosedur teknis di bawah ini untuk menguji endpoint API publik menggunakan metode GET sebagai latihan dasar:

  1. Buka Postman dan Buat Request Baru: Klik tombol New di pojok kiri atas atau ikon tanda tambah (+) di tab workspace, lalu pilih HTTP Request.
  2. Pilih Metode HTTP: Pada dropdown di sebelah kiri kolom URL (secara default bertuliskan GET), pastikan metode GET terpilih.
  3. Masukkan Endpoint URL: Masukkan URL target pengujian pada kolom address bar. Sebagai contoh uji coba publik, Anda dapat menggunakan URL: https://jsonplaceholder.typicode.com/posts/1
  4. Kirim Permintaan (Send): Klik tombol Send berwarna biru di sebelah kanan URL.
  5. Analisis Respons: Perhatikan panel bawah aplikasi. Anda akan melihat status HTTP (misalnya 200 OK), waktu respons (response time), dan ukuran data dalam format JSON.

Menulis Skrip Validasi (Tests) Sederhana

Postman memungkinkan pengujian otomatis menggunakan JavaScript pada tab Tests di bawah kolom URL sebelum tombol Send diklik. Skrip ini berfungsi untuk memvalidasi apakah respons dari server sesuai dengan ekspektasi secara otomatis.

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

// Memeriksa apakah respons JSON memiliki properti 'id'
pm.test("Response has id property", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('id');
});

// Memeriksa waktu respons kurang dari 500ms
pm.test("Response time is less than 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

Tips Troubleshooting Lapangan

  • Error 401 Unauthorized: Periksa bagian tab Authorization di Postman. Pastikan token API (Bearer Token, API Key, atau Basic Auth) sudah dimasukkan dengan benar.
  • Error 404 Not Found: Verifikasi kembali struktur URL endpoint. Kesalahan pengetikan satu karakter pada path URL sering menjadi penyebab utama.
  • Error 500 Internal Server Error: Masalah berasal dari sisi server backend. Periksa payload body yang dikirimkan atau hubungi pengembang backend.
  • Connection Refused: Pastikan server lokal Anda (seperti Node.js, XAMPP, atau Docker) sudah berjalan dan port yang digunakan sudah sesuai.