Klien / Penguji REST API

Susun dan kirim permintaan HTTP dengan parameter kueri, header, badan JSON / formulir, dan autentikasi Basic atau Bearer, lalu periksa status, waktu, dan respons JSON yang diformat rapi. Impor perintah cURL yang sudah ada atau salin permintaan saat ini kembali sebagai cURL. Lebih suka membuat permintaan yang dapat digunakan ulang secara bertahap? Gunakan Pembuat Permintaan HTTP. Lihat juga keluarga Alat API.
Semuanya berjalan secara lokal di browser Anda. Permintaan lintas-asal tunduk pada kebijakan CORS server target — lihat catatan di bawah jika suatu permintaan gagal.
Tempel perintah cURL
Parameter Query
Header
Body
Authorization
Opsi
Ketika diisi, URL permintaan ditambahkan ke awalan ini. Berguna untuk server yang diblokir CORS.
200
Badan Header

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Mengapa permintaan dapat gagal: peramban memblokir pembacaan lintas-asal kecuali API mengembalikan
 Access-Control-Allow-Origin. Jika target tidak mengizinkan CORS, Anda dapat menjalankan proxy CORS milik Anda sendiri dan menempelkan URL-nya
 ke awalan proxy di atas, atau gunakan Konverter cURL untuk menjalankan permintaan dari terminal sebagai gantinya.
 Badan permintaan untuk GET/HEAD diabaikan, dan alat WebSocket berada terpisah di
 Penguji WebSocket.


                                                            

                                                                Metode HTTP dijelaskan
                                                                
Metode yang Anda pilih memberi tahu server apa yang Anda inginkan terhadap URL. Berikut arti dari ketujuh kata kerja yang dapat dikirim alat ini:

                                                                
GET — Ambil sumber daya: halaman web, gambar, daftar catatan. “Berikan apa yang ada di URL ini.” Hanya-baca dan aman diulang, dan biasanya tidak membawa badan permintaan (badan pada permintaan GET, jika ada, diabaikan).

                                                                
POST — Kirim data baru ke server, biasanya untuk membuat sumber daya atau memicu suatu tindakan — mengirim formulir, mengunggah berkas, memulai tugas. Muatan berpindah di badan permintaan. POST tidak idempoten: mengirim POST yang sama dua kali dapat membuat dua catatan.

                                                                
PUT — Ganti seluruh sumber daya di URL dengan apa yang Anda kirim. Badan harus memuat versi baru yang lengkap dari sumber daya. PUT bersifat idempoten: mengulang permintaan yang sama memberikan efek yang sama seperti mengirimnya sekali.

                                                                
PATCH — Ubah hanya sebagian dari sumber daya. Anda hanya mengirim bidang yang ingin diperbarui, misalnya {"email": "new@example.com"}, alih-alih seluruh catatan. Pilih PATCH ketika PUT penuh akan memaksa Anda mengirim ulang bidang yang tidak Anda ubah.

                                                                
DELETE — Hapus sumber daya di URL. DELETE bersifat idempoten: menghapus sesuatu yang sudah hilang memberikan hasil yang sama (biasanya 404) dan tidak melakukan apa-apa dua kali.

                                                                
HEAD — Sama seperti GET, tetapi responsnya hanya berisi header — tidak ada badan yang dikirim kembali sama sekali. Gunakan HEAD untuk memeriksa apakah URL ada, seberapa besar berkasnya (Content-Length), kapan terakhir diubah (Last-Modified), atau jenisnya (Content-Type), tanpa mengunduh seluruh muatan.

                                                                
OPTIONS — Tanyakan kepada server metode dan opsi apa yang diizinkan untuk URL, atau picu pemeriksaan preflight CORS. Header respons, seperti Access-Control-Allow-Methods, mencantumkan apa yang diizinkan. OPTIONS biasanya tidak membawa badan; peramban sering mengirimkannya secara otomatis sebelum POST/PUT/PATCH/DELETE lintas-asal.

                                                                
Mudah tertukar: HEAD vs GET — permintaannya identik, tetapi HEAD tidak mengembalikan badan. PUT vs PATCH — PUT mengganti seluruh sumber daya; PATCH menerapkan pembaruan parsial hanya pada bidang yang dikirim.