Get Méthode

Surcharge 1

Syntaxe

function Get(const aURL: string): string;

Paramètres

Nom	Type	Description
aURL	const string	URL absolue de la ressource à récupérer. Les paramètres de chaîne de requête doivent déjà être encodés.

Valeur de retour

Corps de la réponse reçu du serveur décodé sous forme de chaîne. (string)

Remarques

Utilisez cette surcharge lorsque la réponse est textuelle (HTML, JSON, XML) et tient confortablement en mémoire. La méthode se bloque jusqu'à ce que toutes les trames DATA aient été reçues et retourne le corps concaténé.

Exemple

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

Surcharge 2

Syntaxe

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

Paramètres

Nom	Type	Description
aURL	const string	URL absolue de la ressource à récupérer.
aResponseContent	const TStream	Flux appartenant à l'appelant qui reçoit les octets de réponse bruts au fur et à mesure de leur arrivée.

Remarques

Variante orientée flux destinée aux téléchargements binaires ou aux charges utiles volumineuses où il est indésirable de conserver le corps sous forme de chaîne. La réponse est écrite séquentiellement dans aResponseContent (par exemple un TFileStream).

Exemple

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