Cara Menggunakan Postman untuk Testing API

Ketika membangun atau mengkonsumsi REST API, kamu membutuhkan alat untuk menguji endpoint tanpa harus membuat antarmuka frontend terlebih dahulu. Postman adalah jawaban untuk kebutuhan itu — sebuah platform testing API yang sangat populer di kalangan developer backend maupun frontend. Dengan Postman, kamu bisa mengirim request HTTP, menganalisis respons, mengatur environment variabel, dan bahkan menulis automated test.

Instalasi Postman

Unduh Postman secara gratis dari https://www.postman.com/downloads. Tersedia untuk Windows, macOS, dan Linux. Setelah diinstal, buat akun gratis agar kamu bisa menyimpan koleksi request dan mengaksesnya dari perangkat lain.

Mengirim Request GET

Request GET digunakan untuk mengambil data dari API. Di Postman:

1. Klik tombol New lalu pilih Request.
2. Pilih method GET dari dropdown.
3. Masukkan URL endpoint, misalnya:

https://jsonplaceholder.typicode.com/posts

4. Klik tombol Send.
5. Lihat respons JSON di panel bawah.

Kamu juga bisa menambahkan query parameter di tab Params:

https://jsonplaceholder.typicode.com/posts?userId=1

Mengirim Request POST dengan Body

Request POST digunakan untuk mengirim data ke server. Pilih method POST, masukkan URL, lalu:

1. Buka tab Body.
2. Pilih raw dan format JSON.
3. Masukkan data yang ingin dikirim:

{
  "title": "Artikel Baru",
  "body": "Ini adalah isi artikel",
  "userId": 1
}

4. Klik Send dan perhatikan respons dari server.

Menambahkan Header

Banyak API membutuhkan header khusus, seperti Content-Type atau token autentikasi. Buka tab Headers dan tambahkan:

Content-Type: application/json
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Menggunakan Environment Variables

Daripada menulis URL atau token secara manual di setiap request, gunakan environment variables. Buat environment baru (klik ikon mata di pojok kanan atas), lalu tambahkan variabel:

base_url = https://api.namaproyek.com
token = Bearer eyJhbGciOiJIUzI1NiIs...

Gunakan variabel tersebut di URL atau header dengan sintaks double curly brace:

{{base_url}}/api/users
Authorization: {{token}}

Ini sangat berguna saat beralih antara environment development, staging, dan production.

Mengorganisir Request dalam Collection

Collection adalah folder untuk mengelompokkan request yang saling berkaitan. Buat collection per modul atau per proyek:

• Auth — Login, Register, Logout.
• Users — Get All Users, Get User by ID, Update User, Delete User.
• Products — CRUD product endpoints.

Dengan organisasi yang baik, collection bisa dibagikan ke seluruh tim agar semua developer menggunakan konfigurasi yang sama.

Menulis Test Otomatis

Postman mendukung penulisan test sederhana menggunakan JavaScript di tab Tests:

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

pm.test("Respons berupa JSON", function () {
  pm.response.to.be.json;
});

pm.test("Data user memiliki field name", function () {
  var jsonData = pm.response.json();
  pm.expect(jsonData).to.have.property("name");
});

Test ini akan otomatis dijalankan setiap kali request dikirim, dan hasilnya terlihat di tab Test Results.

Menyimpan Response Token untuk Request Berikutnya

Setelah login, kamu bisa otomatis menyimpan token ke environment variable menggunakan skrip di tab Tests:

var response = pm.response.json();
pm.environment.set("token", "Bearer " + response.data.access_token);

Token ini kemudian bisa langsung digunakan di request lain melalui variabel {{token}}.

Kesimpulan

Postman adalah alat wajib bagi developer yang bekerja dengan API. Dengan fitur collection, environment variables, dan automated testing, kamu bisa menguji seluruh endpoint API dengan terstruktur dan efisien. Mulailah dengan menguji endpoint sederhana, lalu tingkatkan ke penggunaan environment variabel dan test otomatis untuk alur kerja yang lebih profesional. Postman juga memudahkan kolaborasi tim karena collection bisa di-export dan dibagikan dengan mudah.