Daftar HTTP Request Headers dalam cURL: Panduan & Contoh

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 method HEAD dan 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.