Generator & Builder Perintah cURL

Apa Itu Perintah curl?

# Plain GET — curl defaults to GET
curl https://api.example.com/users

# GET with a Bearer token (auth is just a header)
curl https://api.example.com/me \
  -H 'Authorization: Bearer YOUR_TOKEN'

# POST a JSON body — note the Content-Type header
curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada","role":"admin"}'

# Multipart file upload — '@' reads the file from disk
curl -X POST https://api.example.com/upload \
  -F 'file=@report.pdf' \
  -F 'title=Q3 report'

Fitur Utama

Alternatif curl & Klien HTTP

Contoh Perintah curl

curl https://api.example.com/users

curl https://api.example.com/me \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada","role":"admin"}'

curl -X POST https://api.example.com/login \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'username=ada&password=s3cret'

curl -X POST https://api.example.com/upload \
  -F 'file=@report.pdf' \
  -F 'title=Q3 report'

curl -L -o archive.zip \
  https://example.com/files/archive.zip

curl -u ada:s3cret \
  https://api.example.com/private

curl -v -i https://api.example.com/health

Cara Membangun Perintah curl

1. 1

   Pilih metode HTTP

   Pilih GET, POST, PUT, PATCH, DELETE, HEAD, atau OPTIONS. curl default ke GET; memilih POST atau kata kerja lain menambahkan -X METHOD ke perintah yang dihasilkan. Atau ketuk chip preset untuk menetapkan metode dan body yang sesuai dalam satu klik.

2. 2

   Masukkan URL dan parameter query

   Ketik URL permintaan (mis. https://api.example.com/users). Tambahkan parameter query sebagai pasangan kunci/nilai dan alat akan mengodekan URL-nya serta menambahkan ?key=value&… ke URL secara otomatis — tidak perlu pengkodean manual.

3. 3

   Tambahkan header dan autentikasi

   Tambahkan header permintaan sebagai pasangan kunci/nilai, lalu pilih skema auth: None, Bearer token, Basic (nama pengguna/sandi), atau header API-key kustom. Header Authorization atau kustom yang tepat dihasilkan dalam format persis yang diharapkan server.

4. 4

   Atur body permintaan

   Untuk POST/PUT/PATCH, pilih tipe body: tempel JSON mentah (header Content-Type ditambahkan untuk Anda), buat kolom form urlencoded, atau rakit unggahan multipart dan ubah kolom mana pun menjadi file dengan awalan @.

5. 5

   Aktifkan opsi

   Aktifkan flag yang Anda butuhkan — ikuti pengalihan (-L), TLS tidak aman (-k), verbose (-v), sertakan header (-i), terkompresi (--compressed), output ke file (-o), batas waktu koneksi, atau proxy (-x). Setiap toggle memperbarui perintah secara langsung.

6. 6

   Salin, ekspor, atau reset

   Salin perintah yang sudah selesai, Ekspor .sh untuk mengunduhnya sebagai skrip, atau Reset untuk menghapus form. Gunakan toggle Multi-baris untuk beralih antara output satu baris dan multi-baris dengan backslash sebelum Anda menyalin.

Kesalahan curl yang Umum

# Bermaksud PATCH, tetapi -d saja menyiratkan POST
curl -d '{"role":"admin"}' \
  https://api.example.com/users/7

# Tetapkan kata kerja secara eksplisit
curl -X PATCH -d '{"role":"admin"}' \
  -H 'Content-Type: application/json' \
  https://api.example.com/users/7

# Server melihat urlencoded, bukan JSON — 400/415
curl -X POST https://api.example.com/users \
  -d '{"name":"Ada"}'

# Deklarasikan tipe konten JSON
curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada"}'

# $name diperluas oleh shell menjadi string kosong
curl -d "{\"user\":\"$name\"}" \
  https://api.example.com/users

# Tanda kutip tunggal mengirim body secara harfiah
curl -d '{"user":"$name"}' \
  https://api.example.com/users

# -d menjadikan ini POST, bukan GET
curl -d 'page=2&limit=50' \
  https://api.example.com/users

# Query string pada URL menjaganya sebagai GET
curl 'https://api.example.com/users?page=2&limit=50'

:: cmd.exe — backslash bukan karakter kelanjutan
curl -X POST https://api.example.com/users \
  -d '{"name":"Ada"}'

:: cmd.exe — satu baris, atau gunakan ^ untuk melanjutkan
curl -X POST https://api.example.com/users -d "{\"name\":\"Ada\"}"

# Spasi membagi argumen — curl melihat dua argumen
curl https://api.example.com/search?q=hello world

# Kodekan spasi (atau kutip seluruh URL)
curl 'https://api.example.com/search?q=hello%20world'

Kasus Penggunaan Umum

Pengujian REST API

Bangun dan kirim permintaan ke endpoint REST tanpa meninggalkan terminal: atur metode, tempel Bearer token, kirim body JSON, dan baca respons. Cara tercepat untuk mengonfirmasi API berperilaku sebelum menulis kode klien.

Mereproduksi Permintaan dari Dokumentasi

Dokumentasi API menampilkan endpoint dan parameter tetapi jarang perintah lengkap yang siap salin. Isi metode, URL, header, dan auth di sini dan dapatkan perintah curl yang langsung berjalan — tanpa berjuang dengan quoting atau header Content-Type yang hilang.

Skrip Smoke-Test CI/CD

Hasilkan perintah curl untuk pemeriksaan kesehatan atau uji asap pasca-deploy, lalu Ekspor .sh untuk dimasukkan ke pipeline. Tambahkan --connect-timeout dan --max-time agar endpoint yang macet tidak dapat memblokir build, dan periksa kode status dengan -w.

Unggah & Unduh File

Rakit unggahan multipart/form-data dengan -F field=@file, atau buat unduhan -L -o filename yang mengikuti pengalihan ke CDN. Enkode nama file atau nilai query yang sulit terlebih dahulu dengan encoder URL kami.

Debug Webhook

Putar ulang payload webhook dengan POST body JSON yang sama yang dikirim penyedia, dengan header tanda tangan dan Content-Type yang tepat. Reproduksi permintaan persis secara lokal untuk men-debug mengapa handler Anda menolaknya.

Laporan Bug yang Dapat Direproduksi

Tempel satu perintah curl yang berdiri sendiri ke laporan bug atau PR sehingga siapa pun dapat mereproduksi permintaan persis — metode, header, placeholder auth, dan body. Jauh lebih jelas daripada mendeskripsikan permintaan dalam prosa.

Belajar Flag curl

Lihat bagaimana setiap pilihan form dipetakan ke flag nyata — pilih Basic auth dan perhatikan -u muncul, tambahkan body JSON dan perhatikan header Content-Type terlampir. Cara hands-on untuk mempelajari sintaks, dipasangkan dengan cheat sheet curl kami.

Mempersiapkan Permintaan untuk Dikonversi ke Kode

Bangun dan verifikasi permintaan sebagai curl terlebih dahulu, lalu terjemahkan ke klien HTTP aplikasi Anda. Tab Convert yang akan datang akan mengubah perintah curl yang ditempelkan menjadi fetch, requests, Go, PHP, Ruby, dan Node.js — mulai dari perintah curl yang Anda ketahui berfungsi.

Referensi Flag & Sintaks curl

Quoting & Escaping Shell

Alat ini membungkus nilai dalam tanda kutip tunggal, bentuk paling aman di shell POSIX karena tidak ada yang di dalam string bertanda kutip tunggal yang diperluas. Tanda kutip tunggal literal di dalam nilai dihasilkan sebagai urutan '\'' (tutup-kutip, kutip yang di-escape, buka-kutip kembali). Di cmd.exe beralih ke tanda kutip ganda; Git Bash dan WSL menjalankan perintah kutip tunggal yang dihasilkan tanpa perubahan.

-d vs --data-raw vs --data-binary

-d/--data menghapus baris baru dan carriage return dari body — baik untuk pasangan key=value, merusak untuk konten multi-baris. --data-raw sama tetapi tidak memperlakukan @ di awal sebagai nama file. --data-binary mengirim byte persis seperti yang diberikan (gunakan @file untuk mengunggah konten file mentah). Ketiganya menyiratkan POST kecuali metode diganti.

Multipart (-F) vs URL-encoded (-d)

-F field=value menghasilkan multipart/form-data dengan boundary yang dibuat — diperlukan untuk unggah file (-F file=@path) dan form campuran file/teks. -d field=value menghasilkan application/x-www-form-urlencoded, string tunggal yang digabungkan dengan &. Jangan pernah menyetel Content-Type secara manual untuk multipart; curl menghitung boundary dan menyetel header sendiri.

Pengkodean Header Auth

Bearer auth mengirim Authorization: Bearer <token> verbatim (RFC 6750). Basic auth dari -u user:pass dikodekan Base64 menjadi Authorization: Basic <base64> melalui kabel — pengkodean, bukan enkripsi, jadi gunakan HTTPS. API key adalah header kustom apa pun yang diperlukan layanan, mis. X-API-Key: <value>.

Pengkodean Query-String

Parameter query yang ditambahkan di builder dikodekan persen dan ditambahkan sebagai ?key=value&key2=value2. Karakter khusus (spasi, &, =, #) di-escape agar URL valid. Untuk kolom body yang harus dikodekan, --data-urlencode curl sendiri menangani pengkodean saat waktu permintaan.

Perilaku Pengalihan (-L)

Tanpa -L, curl mencetak respons 301/302 dan berhenti. Dengan -L curl mengikuti header Location ke URL akhir. Perhatikan bahwa curl menghapus header Authorization ketika pengalihan berpindah ke host yang berbeda (default keamanan); gunakan --location-trusted hanya ketika Anda memahami implikasinya.

Respons Terkompresi

--compressed menambahkan header Accept-Encoding yang mengiklankan dukungan gzip/deflate/brotli dan secara transparan mendekompres respons, menghemat bandwidth. Body yang didekodekan identik dengan permintaan yang tidak terkompresi — murni optimisasi transfer, aman untuk diaktifkan pada sebagian besar panggilan API.

Output: -o vs -O

-o filename menulis body respons ke file yang Anda namai; -O menyimpannya dengan nama file remote dari path URL. Keduanya menekan dump stdout normal. Gabungkan dengan -L agar pengalihan diselesaikan ke aset nyata sebelum file ditulis.

Praktik Terbaik untuk Permintaan curl

Jangan Pernah Hard-Code Rahasia dalam Perintah yang Dibagikan

Perintah curl yang Anda tempel ke PR, tiket, atau obrolan akan dibaca orang lain dan diindeks oleh alat. Ganti token dan sandi dengan placeholder (YOUR_TOKEN) atau referensikan variabel lingkungan (-H "Authorization: Bearer $API_TOKEN"). Untuk kredensial panjang, curl dapat membaca header dari file dengan -H @headerfile sehingga rahasia tidak pernah muncul di riwayat shell.

Pilih --data-binary @file untuk Payload Biner

Ketika body adalah file yang byte-nya penting — gambar, payload yang ditandatangani, JSON di mana spasi signifikan — gunakan --data-binary @file daripada -d @file. -d biasa menghapus baris baru dan carriage return, secara diam-diam merusak konten biner dan multi-baris. --data-binary mengirim file persis seperti di disk.

Kutip Nilai Header

Selalu bungkus nilai -H dalam tanda kutip: -H 'Content-Type: application/json'. Tanpa tanda kutip, spasi setelah titik dua memisahkan argumen dan curl melihat header yang salah format. Tanda kutip tunggal juga mencegah shell dari memperluas $, *, dan karakter khusus lainnya di dalam nilai — persis seperti yang dihasilkan alat ini secara default.

Gunakan --compressed untuk Menghemat Bandwidth

Tambahkan --compressed pada panggilan API dan unduhan untuk meminta pengkodean gzip/brotli dan biarkan curl mendekompres secara transparan. Untuk API berbasis JSON ini dapat mengurangi ukuran transfer sebesar 70–90% tanpa perubahan pada respons yang Anda lihat — kemenangan gratis dalam skrip yang mem-polling endpoint berulang kali.

Tetapkan Batas Waktu dalam Skrip

Dalam konteks otomatis apa pun, tambahkan --connect-timeout dan --max-time agar endpoint yang lambat atau macet tidak dapat memblokir pipeline selamanya. Pemeriksaan kesehatan dengan --max-time 10 gagal dengan cepat dan membiarkan CI Anda melanjutkan. Gabungkan dengan --retry N untuk menyerap gangguan jaringan sementara tanpa langsung menyerah.

Verifikasi dengan -v Sebelum Mengotomatiskan

Sebelum memanggang perintah curl ke dalam skrip atau cron job, jalankan sekali dengan -v untuk melihat baris permintaan persis, header, dan handshake TLS. Ini adalah cara tercepat untuk menangkap metode yang salah, Content-Type yang hilang, atau header auth yang tidak terlampir — debug secara interaktif, lalu hapus -v untuk produksi.

Pertanyaan yang Sering Diajukan