TsgcHTTP3Client › Métodos › Head

Head Método

Envía una solicitud HTTP/3 HEAD síncrona y devuelve el objeto de respuesta.

Sintaxis

function Head(const aURL: string): TsgcHTTP3Response;

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta del recurso cuyas cabeceras se solicitan.

Valor de Retorno

El objeto de respuesta, que expone el código de estado y las cabeceras de la respuesta. (TsgcHTTP3Response)

Observaciones

Head solicita solo los metadatos de un recurso: el servidor devuelve la línea de estado y las cabeceras pero ningún cuerpo, exactamente igual que lo haría para un Get en la misma URL. Utilícelo para comprobar si un recurso existe, para leer su content-length o content-type, o para probar validadores de caché sin transferir la carga útil. La llamada bloquea hasta que se ha recibido la respuesta y devuelve un TsgcHTTP3Response cuyos StatusCode y Headers están rellenados.

Ejemplo

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

Volver a Métodos