TsgcHTTP3Client › メソッド › Head

Head メソッド

同期 HTTP/3 HEAD リクエストを送信し、レスポンスオブジェクトを返します。

構文

function Head(const aURL: string): TsgcHTTP3Response;

パラメータ

名前	タイプ	説明
aURL	const string	ヘッダーがリクエストされるリソースの絶対 URL。

戻り値

ステータスコードとレスポンスヘッダーを公開するレスポンスオブジェクト。（TsgcHTTP3Response）

解説

Head はリソースのメタデータのみをリクエストします。サーバーは同じ URL に対する Get と同様に、ステータスラインとヘッダーのみを返し、ボディは返しません。リソースが存在するかどうかの確認、content-length や content-type の読み取り、またはペイロードを転送せずにキャッシュバリデーターをテストするために使用してください。呼び出しはレスポンスを受信するまでブロックし、StatusCode と Headers が設定された TsgcHTTP3Response を返します。

使用例

oResponse := oClient.Head('https://api.example.com/v1/file.bin');
Log(IntToStr(oResponse.StatusCode));

メソッドに戻る