Head Method

Envoie une requête HTTP/3 HEAD synchrone et retourne l'objet de réponse.

Syntaxe

function Head(const aURL: string): TsgcHTTP3Response;

Paramètres

Nom	Type	Description
`aURL`	`const string`	URL absolue de la ressource dont les en-têtes sont demandés.

Valeur de retour

L'objet de réponse, exposant le code de statut et les en-têtes de réponse. (TsgcHTTP3Response)

Remarques

Head ne demande que les métadonnées d'une ressource : le serveur retourne la ligne de statut et les en-têtes mais pas de corps, exactement comme il le ferait pour un Get sur la même URL. Utilisez-le pour vérifier si une ressource existe, pour lire son content-length ou son content-type, ou pour tester les validateurs de cache sans transférer la charge utile. L'appel bloque jusqu'à ce que la réponse ait été reçue et retourne un TsgcHTTP3Response dont StatusCode et Headers sont renseignés.

Exemple


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

Retour aux méthodes