Get Método

Sobrecarga 1

Sintaxis

function Get(const aURL: string): string;

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta del recurso que se desea obtener. Los parámetros de la cadena de consulta deben estar ya codificados.

Valor de Retorno

Cuerpo de respuesta recibido del servidor decodificado como cadena de texto. (string)

Observaciones

Utilice esta sobrecarga cuando la respuesta es textual (HTML, JSON, XML) y cabe cómodamente en memoria. El método bloquea hasta que se han recibido todas las tramas DATA y devuelve el cuerpo concatenado.

Ejemplo

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

Sobrecarga 2

Sintaxis

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

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta del recurso que se va a obtener.
aResponseContent	const TStream	Flujo de propiedad del llamador que recibe los bytes de respuesta sin procesar a medida que llegan.

Observaciones

Variante orientada a flujos destinada a descargas binarias o cargas útiles de gran tamaño en las que no es deseable almacenar el cuerpo como cadena. La respuesta se escribe secuencialmente en aResponseContent (por ejemplo, un TFileStream).

Ejemplo

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