Get Método

Overload 1

Sintaxe

function Get(const aURL: string): string;

Parâmetros

Name	Type	Descrição
aURL	const string	URL absoluta do recurso a ser buscado. Os parâmetros de query-string já devem estar codificados.

Valor de retorno

Corpo de resposta recebido do servidor decodificado como string. (string)

Observações

Use esta sobrecarga quando a resposta for textual (HTML, JSON, XML) e couber confortavelmente na memória. O método bloqueia até que todos os frames DATA tenham sido recebidos e retorna o corpo concatenado.

Exemplo

vJSON := oClient.Get('https://api.example.com/v1/users');

Sobrecarga 2

Sintaxe

procedure Get(Const aURL: string; const aResponseContent: TStream);

Parâmetros

Name	Type	Descrição
aURL	const string	URL absoluta do recurso a buscar.
aResponseContent	const TStream	Stream de propriedade do chamador (caller-owned) que recebe os bytes brutos da resposta à medida que chegam.

Observações

Variante orientada a stream destinada a downloads binários ou payloads grandes onde manter o corpo como uma string é indesejável. A resposta é escrita sequencialmente em aResponseContent (por exemplo, um TFileStream).

Exemplo

oStream := TFileStream.Create('image.png', fmCreate);
try
  oClient.Get('https://api.example.com/image.png', oStream);
finally
  oStream.Free;
end;