Get Methode

Overload 1

Syntax

function Get(const aURL: string): string;

Parameter

Name	Typ	Beschreibung
aURL	const string	Absolute URL der abzurufenden Ressource. Query-String-Parameter sollten bereits codiert sein.

Rückgabewert

Vom Server empfangener Antworttext, als String dekodiert. (string)

Hinweise

Verwenden Sie diese Überladung, wenn die Antwort textbasiert ist (HTML, JSON, XML) und bequem in den Speicher passt. Die Methode blockiert, bis alle DATA-Frames empfangen wurden, und gibt den verketteten Body zurück.

Beispiel

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

Überladung 2

Syntax

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

Parameter

Name	Typ	Beschreibung
aURL	const string	Absolute URL der abzurufenden Ressource.
aResponseContent	const TStream	Vom Aufrufer verwalteter Stream, der die rohen Antwort-Bytes empfängt, sobald sie eintreffen.

Hinweise

Stream-orientierte Variante, die für binäre Downloads oder große Nutzlasten gedacht ist, bei denen das Halten des Texts als Zeichenkette unerwünscht ist. Die Antwort wird sequenziell in aResponseContent geschrieben (zum Beispiel ein TFileStream).

Beispiel

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