HTTP Metodu

Her HTTP isteği bir metotla başlar; bu, istemcinin niyetini belirten kısa bir sözcüktür ve ardından bir kaynağın URL'si gelir. GET /users/42 bir kullanıcıyı okumayı, DELETE /users/42 ise onu kaldırmayı ister. Metot, sunucuların, önbelleklerin, proxy'lerin ve tarayıcıların bir isteğin içeriğine bakmadan ne yapacağını anlamasını sağlar.

En çok kullanacağınız beş metot şunlardır: veriyi getiren ve hiçbir şeyi değiştirmemesi gereken GET; bir kaynak oluşturmak ya da bir eylemi tetiklemek için veri gönderen POST; bir kaynağı gönderilen veriyle tamamen değiştiren PUT; kısmi bir güncelleme uygulayan PATCH; ve bir kaynağı kaldıran DELETE. Daha az görünür olanlar arasında GET gibi çalışıp yalnızca başlıkları döndüren HEAD ve bir sunucunun nelere izin verdiğini soran, tarayıcıların CORS preflight isteği olarak gönderdiği OPTIONS yer alır. REST API'lerde bu metotlar CRUD işlemleriyle örtüşür.

Metotlar iki özelliğe göre sınıflandırılır. Güvenli (safe) bir metot (GET, HEAD, OPTIONS) sunucu durumunu değiştirmez; bu yüzden tarayıcılar bağlantıları önceden yükleyebilir ve önbellekler yanıtları saklayabilir. Idempotent bir metot (güvenli olanlar artı PUT ve DELETE) bir kez ya da birkaç kez gönderilmesi fark etmeksizin aynı etkiye sahiptir; dolayısıyla bir istemci onu zaman aşımından sonra yeniden deneyebilir. POST ve PATCH'in ise idempotent olması garanti edilmez ve yeniden denendiğinde kopyalar oluşturabilirler. Metodu bir cümlenin fiili, URL'yi de nesnesi olarak düşünün: 'bu kullanıcıyı getir', 'şu siparişi sil'.

HTTP metotları bazen HTTP durum kodlarıyla karıştırılır. Metodu istekte istemci seçer; 200 veya 404 gibi bir durum kodunu ise yanıtta sunucu seçer. Yaygın bir hata, GET /delete-account gibi veriyi değiştiren eylemler için GET kullanmaktır; tarayıcı botları, bağlantı önizlemeleri veya önceden yükleme bunları yanlışlıkla tetikleyebilir. Bir GET isteğindeki veri de URL'nin sorgu dizesinde (query string) taşınır ve orada loglanır ve önbelleğe alınır; dolayısıyla hassas veriler bir POST'un gövdesinde yer almalıdır.