Get メソッド

オーバーロード 1

構文

function Get(const aURL: string): string;

パラメータ

名前	タイプ	説明
aURL	const string	取得するリソースの絶対 URL。クエリ文字列パラメータはすでにエンコードされている必要があります。

戻り値

文字列としてデコードされた、サーバーから受信したレスポンスボディ。（string）

解説

このオーバーロードはレスポンスがテキスト (HTML、JSON、XML) であり、メモリに快適に収まる場合に使用します。すべての DATA フレームが受信されるまでメソッドはブロックし、結合されたボディを返します。

使用例

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

オーバーロード 2

構文

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

パラメータ

名前	タイプ	説明
aURL	const string	フェッチするリソースの絶対 URL。
aResponseContent	const TStream	受信した生のレスポンスバイトを受け取る呼び出し元所有のストリーム。

解説

バイナリダウンロードや大きなペイロードで本文を文字列として保持することが望ましくない場合に使用するストリーム指向のバリアント。レスポンスは aResponseContent（例: TFileStream）に順次書き込まれます。

使用例

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