TsgcHTTP3Client › Metodi › Head

Head Metodo

Invia una richiesta HTTP/3 HEAD sincrona e restituisce l'oggetto risposta.

Sintassi

function Head(const aURL: string): TsgcHTTP3Response;

Parametri

Nome	Tipo	Descrizione
aURL	const string	URL assoluto della risorsa di cui vengono richiesti gli header.

Valore restituito

L'oggetto risposta, che espone il codice di stato e gli header della risposta. (TsgcHTTP3Response)

Note

Head richiede solo i metadati di una risorsa: il server restituisce la riga di stato e gli header ma nessun corpo, esattamente come farebbe per un Get sullo stesso URL. Utilizzarlo per verificare se una risorsa esiste, per leggerne il content-length o il content-type, oppure per testare i validatori della cache senza trasferire il payload. La chiamata blocca finché la risposta non è stata ricevuta e restituisce un TsgcHTTP3Response i cui StatusCode e Headers sono popolati.

Esempio

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

Torna ai Metodi