Error pada request headers di Postman biasanya terjadi karena ketidaksesuaian format, kunci header yang tidak valid, ketiadaan token otorisasi yang wajib, atau konflik pada nilai Content-Type. Masalah ini menyebabkan server menolak permintaan dengan kode status seperti 400 Bad Request, 401 Unauthorized, atau 403 Forbidden.
Untuk mengatasi kendala ini secara cepat, Anda perlu memeriksa panel Headers di bawah tab URL Postman, memastikan format kunci dan nilai sesuai dengan dokumentasi API, serta menghapus header tersembunyi yang bertabrakan dengan setelan otomatis Postman.
Penyebab Utama dan Solusi Request Headers Error
Berikut adalah tabel matriks penyebab umum error pada header permintaan di Postman beserta solusi teknis yang dapat langsung diterapkan:
| Kode Error / Gejala | Penyebab Utama | Solusi Teknis di Postman |
|---|---|---|
| 400 Bad Request | Format Content-Type salah atau tidak sesuai dengan body payload (misal: kirim JSON tapi header masih text/plain). | Ubah nilai Content-Type menjadi application/json pada tab Headers atau pilih otomatis di tab Body (pilih raw > JSON). |
| 401 Unauthorized | Token Bearer kedaluwarsa, salah ketik, atau format awalan 'Bearer ' hilang. | Periksa tab Authorization, pastikan tipe token benar, dan perbarui token di environment variable. |
| 403 Forbidden | Header kustom wajib seperti X-API-Key atau User-Agent tidak disertakan. | Tambahkan kunci header wajib secara manual di tab Headers sesuai dokumentasi API penyedia. |
| Header Overridden | Postman menimpa header secara otomatis (misal: Content-Length atau Host). | Nonaktifkan header otomatis melalui ikon mata (Auto-set headers) di panel Headers jika diperlukan. |
Langkah-Langkah Teknis Debugging Header di Postman
Ikuti prosedur sistematis berikut untuk mendiagnosis dan memperbaiki error pada header permintaan Anda:
- Buka Postman Console: Tekan kombinasi tombol
Alt + Ctrl + C(Windows) atauOption + Cmd + C(Mac) untuk membuka Postman Console guna melihat header mentah (raw headers) yang dikirimkan ke server. - Periksa Tab Headers: Pastikan tidak ada karakter spasi tersembunyi pada bagian Key atau Value. Karakter tak kasat mata sering menjadi penyebab utama error 400.
- Validasi Token Otorisasi: Jika menggunakan Bearer Token, pastikan Anda tidak menuliskan kata 'Bearer' dua kali di kolom value atau di dalam environment variable.
- Gunakan Snippet Kode untuk Pengujian: Jika masih gagal, gunakan fitur 'Code' di sisi kanan layar Postman untuk mengekspor permintaan ke format cURL dan ujui langsung melalui terminal/command prompt.
Contoh Format Header JSON yang Benar
Pastikan struktur header permintaan Anda mengikuti standar baku HTTP seperti contoh kode di bawah ini:
POST /api/v1/resource HTTP/1.1
Host: api.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Content-Type: application/json
Accept: application/jsonDengan memastikan konsistensi antara header yang dikirim dan spesifikasi backend server, sebagian besar error koneksi dan penolakan autentikasi pada Postman dapat diselesaikan seketika.