Cara Memposting Data JSON Menggunakan cURL

Saat melakukan pengujian API, data JSON umumnya digunakan untuk transmisi data. Mengingat cURL adalah alat baris perintah standar untuk pengujian API, muncul pertanyaan: Bagaimana cara mengirim data JSON menggunakan perintah cURL? Artikel ini memandu Anda melalui proses POST data JSON menggunakan perintah cURL.

💡

Permintaan POST mengirimkan data ke server untuk diproses, dengan data yang disertakan dalam badan permintaan. Ini umumnya digunakan untuk mengirimkan formulir web dan membuat atau memodifikasi sumber daya. Untuk lebih memahami dan menguji permintaan POST, mari coba Apidog, alat pengembangan API yang hebat.

button

Apa itu cURL?

cURL (singkatan dari Client for URLs) adalah alat dan pustaka baris perintah untuk mentransfer data dengan URL. Ini mendukung berbagai protokol, termasuk HTTP, HTTPS, FTP, FTPS, SCP, SFTP, LDAP, LDAPS, DICT, TELNET, FILE, dan banyak lagi.

cURL banyak digunakan dalam komunitas pengembangan dan pembuatan skrip untuk membuat permintaan HTTP, mengunduh atau mengunggah file, dan berinteraksi dengan berbagai layanan jaringan.

Sintaks dasar untuk menggunakan cURL adalah:

bashCopy code
curl [options] [URL...]

Berikut adalah beberapa opsi umum:

-X: Menentukan metode HTTP (GET, POST, PUT, DELETE, dll.).
-H: Menambahkan header khusus ke permintaan.
-d: Mengirim data dalam badan permintaan (digunakan untuk permintaan POST).
-o: Menulis output ke file.
-O: Mengunduh file dan menggunakan nama file jarak jauh.
-L: Mengikuti pengalihan.
-u: Menyediakan nama pengguna dan kata sandi untuk autentikasi.

Apa itu JSON?

JSON, yang merupakan singkatan dari JavaScript Object Notation, adalah format pertukaran data yang ringan. Mudah dibaca dan ditulis oleh manusia dan mudah diuraikan dan dibuat oleh mesin. Data JSON direpresentasikan sebagai pasangan kunci-nilai, mirip dengan bagaimana objek direpresentasikan dalam banyak bahasa pemrograman.

Data JSON terdiri dari dua struktur:

Objek: Kumpulan pasangan kunci-nilai yang tidak berurutan yang diapit dalam kurung kurawal {}. Setiap kunci adalah string, diikuti oleh titik dua, dan kemudian nilai terkait.
Array: Daftar nilai yang diurutkan yang diapit dalam tanda kurung siku []. Nilai dalam array dapat berupa tipe data apa pun, termasuk objek dan array.

Berikut adalah contoh data JSON sederhana:

{
  "title": "The Catcher in the Rye",
  "author": "J.D. Salinger",
  "publishedYear": 1951,
  "isAvailable": true,
  "genres": ["Fiction", "Coming-of-age"]
}

Dalam contoh ini:

Objek JSON mewakili buku dengan atribut seperti title, author, publishedYear, dan isAvailable.
Bidang genres adalah array string yang mewakili genre buku.

Apa itu Permintaan POST?

Permintaan POST adalah metode permintaan HTTP yang digunakan untuk mengirim data ke server untuk diproses. Data disertakan dalam badan permintaan, bukan URL. Permintaan POST umumnya digunakan untuk mengirimkan formulir web, membuat sumber daya baru di server, dan memodifikasi data yang ada.

Menggunakan cURL untuk POST Data JSON

Untuk menggunakannya untuk POST data JSON, Anda dapat mengikuti langkah-langkah ini menggunakan contoh JSON yang Anda berikan:

Berikut adalah cara Anda dapat menggunakan cURL untuk membuat permintaan POST dengan data JSON ini:

curl -X POST -H "Content-Type: application/json" -d @book.json http://example.com/api/books

Mari saya uraikan perintahnya:

-X POST: Menentukan metode permintaan HTTP sebagai POST.
-H "Content-Type: application/json": Mengatur header Content-Type untuk menunjukkan bahwa badan permintaan dalam format JSON.
-d @book.json: Mengirim data dari file book.json dalam badan permintaan.
http://example.com/api/books: Ganti ini dengan URL sebenarnya tempat Anda ingin mengirim permintaan POST.

Pastikan untuk mengganti http://example.com/api/books dengan endpoint sebenarnya tempat Anda ingin mengirim permintaan POST.

Jika Anda tidak memiliki data dalam file dan ingin mengirimkannya langsung dalam perintah, Anda dapat melakukan sesuatu seperti ini:

curl -X POST -H "Content-Type: application/json" -d '{"title":"The Catcher in the Rye","author":"J.D. Salinger","publishedYear":1951,"isAvailable":true,"genres":["Fiction","Coming-of-age"]}' http://example.com/api/books

Perintah ini menyertakan data JSON langsung dalam perintah menggunakan opsi -d. Sekali lagi, ganti URL dengan endpoint sebenarnya yang sedang Anda kerjakan.

Cara Mudah Mengirim POST Data JSON dengan Apidog

Mengirim data JSON dengan mudah sangat penting untuk kelancaran penggunaan API. Sementara pengguna yang paham teknologi mungkin menangani baris perintah cURL, ini bisa jadi rumit bagi yang lain. Apidog hadir dengan antarmuka yang ramah pengguna, sehingga memudahkan semua orang.

Antarmuka Apidog menyederhanakan seluruh proses. Pengguna dapat dengan mudah memilih metode HTTP dan format data.

Apidog bersinar dengan rangkaian fitur lengkapnya, menangani segala sesuatu mulai dari desain API hingga pengujian. Ini adalah alat terpadu untuk semua hal yang berhubungan dengan API, baik Anda membuatnya atau memperbaikinya.

Mengirim JSON dengan Apidog sangat mudah. Cukup pilih POST, buka tab Body, pilih JSON, dan masukkan data Anda. Apidog melewati baris perintah yang rumit, memungkinkan pengguna memasukkan JSON secara langsung. Ini sempurna untuk siapa saja yang bekerja di bidang API, apa pun latar belakang teknologi mereka atau pengalaman dengan alat seperti cURL.

button