TsgcHTTP3Client › Metody › Head

Head Metoda

Wysyła synchroniczne żądanie HTTP/3 HEAD i zwraca obiekt odpowiedzi.

Składnia

function Head(const aURL: string): TsgcHTTP3Response;

Parametry

Nazwa	Typ	Opis
aURL	const string	Bezwzględny URL zasobu, którego nagłówki są żądane.

Wartość zwracana

Obiekt odpowiedzi, udostępniający kod statusu i nagłówki odpowiedzi. (TsgcHTTP3Response)

Uwagi

Head żąda wyłącznie metadanych zasobu: serwer zwraca linię statusu i nagłówki bez treści, dokładnie tak jak w przypadku żądania Get dla tego samego URL. Użyj tej metody, aby sprawdzić, czy zasób istnieje, odczytać jego content-length lub content-type albo przetestować walidatory pamięci podręcznej bez pobierania zawartości. Wywołanie blokuje do momentu odebrania odpowiedzi i zwraca obiekt TsgcHTTP3Response, w którym wypełnione są pola StatusCode i Headers.

Przykład

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

Powrót do metod