Get Methode

Overload 1

Syntaxis

function Get(const aURL: string): string;

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL van de te laden resource. Querystring-parameters moeten al zijn gecodeerd.

Retourwaarde

Responsebody die van de server is ontvangen, gedecodeerd als een string. (string)

Opmerkingen

Gebruik deze overload wanneer het antwoord tekstueel is (HTML, JSON, XML) en comfortabel in het geheugen past. De methode blokkeert totdat alle DATA-frames zijn ontvangen en retourneert de aaneengesloten body.

Voorbeeld

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

Overload 2

Syntaxis

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

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL van de op te halen resource.
aResponseContent	const TStream	Door de aanroeper beheerde stream die de onbewerkte antwoordbytes ontvangt zodra ze binnenkomen.

Opmerkingen

Streamgeoriënteerde variant bedoeld voor binaire downloads of grote payloads waarbij het bewaren van de inhoud als tekenreeks ongewenst is. De respons wordt opeenvolgend geschreven naar aResponseContent (bijvoorbeeld een TFileStream).

Voorbeeld

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