Materi
Metode di baris permintaan menyatakan maksud klien. GET meminta representasi sumber daya. POST meminta server memproses isi kiriman menurut aturan sumber daya itu, misalnya membuat pesanan baru. PUT meminta keadaan sumber daya diganti seluruhnya dengan isi kiriman. PATCH, yang ditetapkan RFC 5789, meminta perubahan sebagian. DELETE meminta sumber daya dihapus. Nama metode membedakan huruf besar dan kecil (RFC 9110 §9.1), dan semua metode standar ditulis dengan huruf besar.
RFC 9110 memberi metode dua sifat. Metode aman pada dasarnya hanya membaca: klien tidak meminta perubahan apa pun di server. GET, HEAD, OPTIONS, dan TRACE aman. Metode idempoten memberi efek yang sama pada server, entah permintaannya dikirim sekali atau berkali-kali: semua metode aman ditambah PUT dan DELETE. POST dan PATCH tidak aman dan tidak idempoten.
| Metode | Aman | Idempoten | Contoh maksud |
|---|---|---|---|
| GET | ya | ya | ambil data buku 7 |
| POST | tidak | tidak | buat peminjaman baru |
| PUT | tidak | ya | ganti seluruh data buku 7 |
| PATCH | tidak | tidak | ubah stok buku 7 saja |
| DELETE | tidak | ya | hapus buku 7 |
Kedua sifat itu punya akibat nyata. RFC 9110 menyebut pembedaan aman dan tidak aman dibuat supaya perayap (spider) dan pengambilan awal (prefetch) bisa bekerja tanpa merusak apa pun. Permintaan idempoten boleh diulang otomatis bila sambungan putus sebelum respons terbaca: PUT stok = 15 yang terkirim dua kali tetap menghasilkan stok 15, sedangkan POST peminjaman yang terkirim dua kali bisa mencatat dua peminjaman.
