Dalam penggunaan utilitas baris perintah cURL untuk berinteraksi dengan server web, pengelolaan HTTP request headers sangat esensial guna menentukan otentikasi, tipe konten, agen pengguna, dan preferensi penanganan data. Pengembang menggunakan flag -H atau --header untuk menyisipkan informasi tambahan pada setiap permintaan HTTP yang dikirimkan ke endpoint server.
Artikel ini menyajikan daftar header HTTP paling krusial yang sering disertakan dalam perintah cURL, lengkap dengan fungsi spesifik dan contoh implementasi teknisnya di terminal.
Daftar HTTP Request Headers Utama dalam cURL
Berikut adalah tabel referensi cepat untuk header HTTP yang paling sering digunakan beserta fungsinya dalam perintah cURL:
| Nama Header | Fungsi Utama | Contoh Nilai |
|---|---|---|
Content-Type |
Menentukan format data payload yang dikirim ke server. | application/json |
Accept |
Menyatakan format respons yang diinginkan dari server. | application/json |
Authorization |
Menyertakan kredensial otentikasi (Token, API Key, Basic Auth). | Bearer eyJhbGciOi... |
User-Agent |
Mengidentifikasi aplikasi atau perangkat klien pengirim request. | Mozilla/5.0 (Windows NT 10.0) |
Host |
Menentukan nama domain host target (berguna untuk pengujian DNS lokal). | api.example.com |
Cache-Control |
Mengatur instruksi caching untuk mekanisme cache di sepanjang jalur request. | no-cache |
Cookie |
Mengirimkan data cookie yang tersimpan kembali ke server. | session_id=xyz123 |
Contoh Penggunaan cURL dengan Multiple Headers
Untuk menyertakan lebih dari satu header dalam satu eksekusi cURL, gunakan flag -H secara berulang untuk setiap baris header yang ingin dikirimkan. Contoh berikut menunjukkan pengiriman data JSON dengan header otentikasi Bearer Token:
curl -X POST "https://api.example.com/v1/resource" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"name": "Azwinn", "status": "active"}'
Tips Troubleshooting & Analisis Header
Saat mendiagnosis masalah jaringan atau integrasi API, seringkali diperlukan pemeriksaan terhadap header respons (response headers) yang dikembalikan oleh server, bukan hanya request headers. Gunakan flag -i atau -I untuk melihat header tersebut:
curl -i URL: Menampilkan HTTP headers respons beserta isi body dari dokumen atau data yang diminta.curl -I URL: Mengirimkan methodHEADdan hanya menampilkan HTTP headers respons tanpa isi body, sangat efisien untuk memeriksa status kode server secara cepat.curl -v URL: Mode verbose yang menampilkan seluruh proses komunikasi secara rinci, termasuk handshake TLS/SSL, request headers yang dikirim, hingga response headers yang diterima.