TsgcHTTP3Client › Métodos › Head

Head Method

Envia uma requisição HTTP/3 HEAD síncrona e retorna o objeto de resposta.

Sintaxe

function Head(const aURL: string): TsgcHTTP3Response;

Parâmetros

Name	Type	Descrição
aURL	const string	URL absoluta do recurso cujos cabeçalhos são solicitados.

Valor de retorno

O objeto de resposta, expondo o código de status e os cabeçalhos de resposta. (TsgcHTTP3Response)

Observações

Head solicita apenas os metadados de um recurso: o servidor retorna a linha de status e os cabeçalhos, mas nenhum corpo, exatamente como faria para um Get na mesma URL. Use-o para verificar se um recurso existe, para ler seu content-length ou content-type, ou para testar validadores de cache sem transferir o payload. A chamada bloqueia até que a resposta seja recebida e retorna um TsgcHTTP3Response cujos StatusCode e Headers estão preenchidos.

Exemplo

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

Voltar para Métodos