TsgcHTTP3Client › Methoden › Head

Head Methode

Verstuurt een synchrone HTTP/3 HEAD-aanvraag en retourneert het antwoordobject.

Syntaxis

function Head(const aURL: string): TsgcHTTP3Response;

Parameters

NaamTypeBeschrijving
aURLconst stringAbsolute URL van de resource waarvan de headers worden opgevraagd.

Retourwaarde

Het antwoordobject dat de statuscode en de antwoordheaders blootstelt. (TsgcHTTP3Response)

Opmerkingen

Head vraagt alleen de metadata van een resource op: de server retourneert de statusregel en headers maar geen body, precies zoals bij een Get op dezelfde URL. Gebruik het om te controleren of een resource bestaat, om de content-length of content-type te lezen, of om cachevalidators te testen zonder de payload over te brengen. De aanroep blokkeert totdat het antwoord is ontvangen en retourneert een TsgcHTTP3Response waarvan de StatusCode en Headers zijn ingevuld.

Voorbeeld


oResponse := oClient.Head('https://api.example.com/v1/file.bin');
Log(IntToStr(oResponse.StatusCode));

Terug naar methoden