Testing API dengan Postman
Postman membantu kamu mengetes API tanpa harus menulis aplikasi penuh. Materi ini fokus pada method, endpoint, header, body, status code, dan cara membaca error.
- Membaca endpoint dan method
- Mengisi header dan body
- Menafsirkan status code dasar
Sebelum mulai
- Paham request, response, dan JSON.
- Install atau buka Postman versi web/desktop.
Konsep utama
01Endpoint dan method
Endpoint adalah alamat API. Method seperti GET, POST, PUT, dan DELETE menjelaskan jenis tindakan yang diminta.
Kenapa penting: Docs API biasanya dimulai dari endpoint dan method, jadi dua hal ini harus cepat dikenali.
Contoh: GET /customers mengambil data pelanggan, sedangkan POST /customers membuat pelanggan baru.
Yang sering keliru: Memakai method yang salah untuk tindakan yang diinginkan.
02Header dan body
Header membawa metadata seperti authorization dan content type. Body membawa data utama yang dikirim.
Kenapa penting: Banyak request gagal bukan karena endpoint salah, tetapi karena header atau body tidak sesuai schema.
Contoh: Header berisi Authorization: Bearer token, body berisi email dan nama pelanggan dalam JSON.
Yang sering keliru: Menaruh API key di tempat yang salah atau membagikannya di screenshot.
03Status code dan error
Status code memberi sinyal hasil request, seperti 200 berhasil, 400 format salah, 401 auth gagal, atau 429 rate limit.
Kenapa penting: Status code mempercepat debugging integrasi.
Contoh: Response 401 berarti cek token atau permission, bukan mengubah semua payload.
Yang sering keliru: Mengabaikan response body yang biasanya menjelaskan detail error.
Cara kerjanya
Postman adalah aplikasi untuk mengirim request ke API dan melihat hasilnya. Sebelum mengotomasi sesuatu dengan API, penting untuk test manual dulu tau apakah endpoint-nya benar, response-nya sesuai harapan, dan error-nya bisa ditangani.
Setiap request punya komponen: method (GET, POST, PUT, DELETE), URL endpoint, headers (termasuk API key atau token), dan body (data yang dikirim). Response berisi status code (200 OK, 401 Unauthorized, 404 Not Found, 500 Server Error), body (hasil dari server), dan headers (metadata).
Postman memungkinkan menyimpan request dalam collection, menggunakan environment variables agar tidak hardcode API key, dan membuat test script sederhana untuk memverifikasi response. Ini memudahkan reproduksi dan berbagi hasil test dengan tim.
Contoh nyata
Coba sendiri
- 1
Install Postman atau pakai web version.
- 2
Cari API publik (misal JSONPlaceholder) dan buat request GET.
- 3
Analisis response: status code, headers, dan body.
- 4
Buat environment variable untuk base URL.
- 5
Buat collection dengan 3 request berbeda.
Prompt yang bisa dipakai
Cek pemahaman
Jawab dengan bahasa sendiri. Kalau masih muter-muter, baca ulang bagian yang paling nyangkut.
- 1
Apa beda status code 200, 401, 404, dan 500?
- 2
Kenapa penting test API manual sebelum mengotomasi?
- 3
Apa gunanya environment variables di Postman?