HTTPmetoder

HTTP-metoder är en uppsättning av åtgärder som klienter kan begära i HTTP-förfrågningar för att ange vilken handling som ska utföras på en resurs. De mest använda metoderna är GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS samt de mindre vanliga TRACE och CONNECT. Metoderna är definierade i HTTP/1.1-standarden (RFC 7231).

Semantiskt används metoderna för att beskriva avsedd åtgärd utan att behöva titta på innehållet i förfrågan. Säkerhet, idempotens och cachebarhet är viktiga begrepp. En säker (safe) metod bör inte förändra serverns tillstånd och omfattas vanligtvis av GET, HEAD och OPTIONS. Icke-säker innebär att tillstånd kan ändras. Idempotens betyder att upprepade likalydande förfrågningar ger samma resultat som en ensam begäran; GET, PUT, DELETE, HEAD, OPTIONS och TRACE är vanligtvis idempotenta. POST används för att skapa nya resurser och är oftast icke-idempotent, medan PATCH används för partiella uppdateringar och kan vara idempotent beroende på hur det används. Cachebarhet gäller främst svar på GET; andra metoder kan vara cachebara om svaret anger det i rubrikerna (t.ex. Cache-Control).

Användningsmönster: GET hämtar en resurs utan att förändra den; POST skickar data för att skapa eller utföra en åtgärd; PUT skapar eller uppdaterar en resurs vid en specificerad URI och kan fungera som ersättande operation; PATCH gör partiell uppdatering; DELETE tar bort en resurs. OPTIONS frågar vilka metoder servern stödjer, och TRACE används för diagnostik men används sällan och ofta av säkerhetsskäl stängs den av. CONNECT används för att etablera tunnlar, till exempel för att köra TLS över en proxytjänst.

Design och säkerhet: I REST-liknande arkitekturer används metoderna som verb för att styra åtkomst till resurser, medan tillståndshistorik lagras i resurserna och svaren. För webbläsarbaserade klienter förväntas CSRF-skydd för metoder som ändrar tillstånd. CORS och preflight-förfrågningar kan spela en roll i korsdomän-scenarier. Dokumentation av vilka metoder som stöds av ett API är viktig för interoperabiliteten.