Get Metodo

Overload 1

Sintassi

function Get(const aURL: string): string;

Parametri

Nome	Tipo	Descrizione
aURL	const string	URL assoluto della risorsa da recuperare. I parametri della query string devono essere già codificati.

Valore restituito

Corpo della risposta ricevuta dal server decodificato come stringa. (string)

Note

Utilizzare questo overload quando la risposta è testuale (HTML, JSON, XML) e si adatta comodamente in memoria. Il metodo si blocca finché tutti i frame DATA sono stati ricevuti e restituisce il corpo concatenato.

Esempio

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

Sovraccarico 2

Sintassi

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

Parametri

Nome	Tipo	Descrizione
aURL	const string	URL assoluto della risorsa da recuperare.
aResponseContent	const TStream	Stream di proprietà del chiamante che riceve i byte grezzi della risposta man mano che arrivano.

Note

Variante orientata allo stream destinata ai download binari o ai payload di grandi dimensioni, dove non è desiderabile mantenere il corpo come stringa. La risposta viene scritta in sequenza in aResponseContent (ad esempio un TFileStream).

Esempio

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