Head Methode

Sendet eine synchrone HTTP/3-HEAD-Anfrage und gibt das Antwortobjekt mit dem Status und den Headern zurück.

Syntax

function Head(const aURL: string): TsgcHTTP3Response;

Parameter

Name	Typ	Beschreibung
`aURL`	`const string`	Absolute URL der Ressource, deren Header angefordert werden.

Rückgabewert

Das Antwortobjekt, das den Statuscode und die Antwort-Header bereitstellt. (TsgcHTTP3Response)

Hinweise

HEAD fordert nur die Metadaten einer Ressource an: Der Server gibt den Status und die Header zurück, jedoch keinen Body, genau wie bei einem Get auf dieselbe URL. Verwenden Sie es, um zu prüfen, ob eine Ressource existiert, um ihre content-length oder content-type zu lesen oder um Cache-Validatoren zu testen, ohne die Payload zu übertragen.

Der Aufruf blockiert, bis die Antwort empfangen wurde, und gibt eine TsgcHTTP3Response zurück, deren StatusCode und Headers gefüllt sind. Anders als die übrigen Verben gibt Head das Antwortobjekt selbst zurück statt einer Zeichenfolge, und es hat kein asynchrones Gegenstück und keine Stream-Überladung.

Beispiel



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

ShowMessage(IntToStr(oResponse.StatusCode));

ShowMessage(oResponse.Headers.Values['content-length']);

Zurück zu Methoden