Cara memakai
- Tempel satu perintah curl ke Perintah curl. Biarkan tanda kutip di sekitar nilai yang berisi spasi.
- Baca Hasil penerjemahan untuk memeriksa setiap opsi: metode, string kueri, isi dan header.
- Salin Kode Python ke dalam skrip Anda, dengan pustaka requests yang terpasang, atau Kode JavaScript fetch ke dalam halaman.
- Jika ada catatan atau galat, perbaiki perintahnya lebih dulu, lalu salin kodenya lagi.
Opsi curl yang dibaca alat
Alat membaca opsi yang paling sering dipakai permintaan. Setiap opsi mengubah panggilan Python dengan cara yang sudah diketahui, dan opsi lain menghentikan penerjemahan dengan sebuah pesan, sehingga tidak ada yang ditebak.
- -X dan --request mengatur metode, seperti yang ditulis. Manual menyatakan bahwa opsi itu hanya mengubah kata yang dikirim.
- -H dan --header menambahkan header. Baris seperti X-Flag; mengirim nilai kosong, dan -H dengan nilai kosong setelah titik dua menghapus header.
- -d, --data, --data-raw dan --data-binary mengatur isi. Beberapa nilai -d digabung dengan &. Dengan -G, nilainya menjadi string kueri sebagai gantinya.
- -G dan --get, -I dan --head, serta -L dan --location mengubah metode atau penanganan pengalihan.
- -u dan --user, -A dan --user-agent, serta -b dan --cookie mengatur tuple autentikasi, header User-Agent dan header Cookie.
- --json mengirim nilainya sebagai isi dan mengatur header JSON, yang dapat ditimpa oleh -H.
Cara perintah dibaca
Teks dipecah menjadi kata-kata seperti shell POSIX memecahnya. Tanda kutip tunggal menjaga setiap karakter. Di dalam tanda kutip ganda, garis miring terbalik hanya meloloskan karakter $, tanda backtick, tanda kutip ganda, garis miring terbalik dan baris baru. Garis miring terbalik di akhir baris menyambungkannya ke baris berikutnya. Ekspansi shell seperti $HOME tidak dijalankan, sehingga nilai seperti itu dilaporkan sebagai galat.
Yang tidak diperiksa alat
- Alat tidak mengirim permintaan, jadi tidak dapat mengetahui apakah server menerimanya.
- Peramban menerapkan aturan lintas-asalnya pada fetch. Permintaan ke situs lain dapat diblokir di sana, meskipun perintah yang sama berfungsi di terminal. Alat tidak menguji itu.
- Alat tidak membuka berkas yang diberi nama dengan @, dan tidak membaca berkas cookie.
- Alat hanya menulis kode Python. Kode memakai pustaka requests, yang Anda pasang sendiri.
Contoh: PUT dengan isi JSON
Perintah ini mengirim PUT ke satu item dengan isi JSON. Metodenya berasal dari -X, header dari -H dan isinya dari -d. Panggilan Python memiliki tiga bagian yang sama, dan daftar langkah menyebutkan opsi mana yang memberi nilai mana.
| Opsi curl | Argumen Python | Nilai dalam kode |
|---|---|---|
| -X PUT | method | 'PUT' |
| -H 'Content-Type: application/json' | headers | 'Content-Type': 'application/json' |
| -d '{"name": "Ada"}' | data | '{"name": "Ada"}' |
Pertanyaan yang sering diajukan
Mengapa kode memakai requests dan bukan pustaka lain?
requests adalah pustaka Python tempat alat ini menerjemahkan, dan fungsi request-nya menerima metode, URL, header, data dan autentikasi dalam satu panggilan. Panggilan yang sama berfungsi untuk setiap metode yang disebut perintah.
Mengapa permintaan saya dikirim sebagai POST padahal saya tidak menulis -X?
Manual curl menyatakan bahwa -d memakai POST, dan --json juga mengirim POST. Tulis -X dengan metode yang Anda inginkan, seperti -X PUT, untuk mengubah kata yang dikirim.
Apa yang dilakukan -G dalam penerjemahan?
Ia memindahkan data -d ke dalam URL sebagai string kueri dan menjadikan permintaan sebagai GET, seperti yang dijelaskan manual. Panggilan Python kemudian memiliki URL lengkap dan tanpa isi.
Apakah kata sandi dalam perintah saya dikirim ke suatu tempat?
Tidak. Perintah dibaca di peramban Anda, dan tidak ada yang disimpan atau dikirim kepada kami. Meski begitu, gunakan kata sandi atau token uji di halaman yang tidak Anda kendalikan.
Mengapa keluaran menyebut pengalihan?
curl mengikuti pengalihan hanya dengan -L. requests mengikutinya secara baku untuk setiap metode, dan fetch juga, sehingga catatan memberi tahu cara menyamakan panggilan curl yang tidak memakai -L.
Bisakah alat membaca data dari berkas yang diberi nama dengan @?
Tidak. Alat tidak membuka berkas, sehingga nilai @ dilaporkan sebagai galat. Tempel datanya langsung ke dalam perintah.
Sumber
- curl manual: -X, -H, -d, -G, -I, -u, -A, -b, -L, --json and --basic (dalam bahasa Inggris)
- POSIX Shell Command Language, section 2.2 Quoting (dalam bahasa Inggris)
- Requests: API reference for request, get, post and head (dalam bahasa Inggris)
Angka dan teks terakhir diperiksa pada Selasa, 10 November 2026.