GETverzoek

Een GETverzoek is een HTTP-verzoeksmethode die wordt gebruikt om een representatie van een bron op een server op te halen. Het doel is om data terug te krijgen zonder de staat van de server te wijzigen. Een GETverzoek identificeert de gewenste bron door middel van een Uniform Resource Identifier (URL).

Eigenschappen: veilig en idempotent. 'Veilig' betekent dat het verzoek geen bijwerkingen zou moeten hebben op de server; herhaalde uitvoering levert dezelfde toestand en dezelfde respons op (mits de bron niet tussentijds verandert). 'Idempotent' betekent dat meerdere identieke GETverzoeken hetzelfde resultaat opleveren. In de praktijk kan caching van GET-responses voorkomen; de server kan cache-headers sturen zoals Cache-Control en ETag. Een GET-verzoek heeft doorgaans geen verzoekbody; data kan wel in de querystring van de URL worden meegegeven.

Gebruik: browsers vervullen GETverzoeken bij het openen van een URL of klikken op een hyperlink; forms kunnen in HTML met method="get" gegevens in de URL plaatsen. API's en webdiensten leveren vaak via GET representaties zoals HTML, JSON of XML. Een GET-verzoek is vaak bookmarkbaar omdat de volledige query in de URL staat.

Beperkingen en beveiliging: gevoelige gegevens horen niet in de URL te staan, omdat queryparameters in browsergeschiedenis, serverlogboeken en Referer-headers kunnen verschijnen. Voor acties die data wijzigen (creëren, bijwerken of verwijderen) wordt doorgaans POST, PUT of DELETE gebruikt. Voor authenticatie-mogelijkheden is het veiliger om tokens via headers te verzenden dan in de URL.