Leg uit waarom er een request body (body), headers (headers) en query parameters (query parameters) bestaan, en waarom ze niet in één kunnen worden samengevoegd.

De inhoud van het verzoek (body), de headers en de query parameters bestaan om verschillende soorten informatie die in een HTTP-verzoek worden verzonden te scheiden, en ze kunnen niet worden gecombineerd omdat ze verschillende functies vervullen en verschillende doeleinden hebben.

Query Parameters

• Worden in de URL na het ?-teken verzonden.
• Worden gebruikt om gegevens te filteren, sorteren, pagineren of een kleine hoeveelheid niet-gevoelige informatie over te dragen die nodig is voor de uitvoering van de operatie.
• Worden vaak gebruikt met GET-verzoeken, omdat ze geen body hebben.
• Zijn zichtbaar in de URL, dus niet geschikt voor het overdragen van vertrouwelijke gegevens.
• Beperkt in lengte door de URL.

Voorbeeld: GET /users?pageSize=10&page=2&sort=name

Headers

• Verzenden meta-informatie over het verzoek en het antwoord.
• Bevatten gegevens zoals content-type, codering, authenticatietokens, informatie over de client (User-Agent), caching, enz.
• Worden gebruikt om het gedrag van het verzoek/antwoord te beheren, niet om operationele gegevens over te dragen.

Voorbeelden van headers: Content-Type: application/json Authorization: Bearer <token> User-Agent: Mozilla/5.0 (...)

Body van het verzoek

• Bevat de hoofdgegevens die naar de server worden gestuurd voor verwerking.
• Wordt gebruikt bij verzoeken die de status op de server wijzigen (POST, PUT, PATCH) of grote hoeveelheden gegevens verzenden.
• Typische formaten: JSON, XML, formulieren (urlencoded/multipart).
• Niet beperkt in grootte (binnen praktische grenzen).
• Wordt niet weergegeven in de URL.

Voorbeeld van de body van een POST-verzoek:

{
  "name": "John Doe",
  "email": "john.doe@example.com"
}

Waarom niet combineren:

• Semantiek: Elk onderdeel draagt zijn eigen semantische lading. Parameters bepalen wat opgevraagd wordt (filters), headers bepalen hoe het wordt opgevraagd (metagegevens), en de body verzendt gegevens voor verwerking.
• HTTP-protocol: De structuur van HTTP scheidt deze componenten duidelijk, waardoor client- en serverapplicaties ze correct kunnen parseren en verwerken.
• Prestaties en caching: Scheiding maakt het mogelijk dat HTTP-infrastructuur (proxy's, caches, enz.) verzoeken efficiënt verwerkt, bijvoorbeeld door antwoorden op GET-verzoeken met dezelfde URL-parameters te cachen.
• Beveiliging: Het overdragen van vertrouwelijke gegevens in de URL (parameters) is onveilig, omdat ze kunnen worden geregistreerd in logs of browsergeschiedenis. Hiervoor is de body bedoeld.
• Beperkingen: Query-parameters hebben een lengtebeperking op de URL, waardoor ze niet geschikt zijn voor het overdragen van grote hoeveelheden gegevens. De body heeft deze beperking niet.

Het combineren van deze elementen in één zou leiden tot verlies van structuur, het moeilijk maken van het parseren en verwerken van HTTP-verzoeken, en het in gevaar brengen van de beveiliging en efficiëntie.