Patch メソッド

ボディペイロードを含む同期 HTTP/3 PATCH リクエストを送信し、レスポンスボディを返します。

構文

function Patch(const aURL: string; const aData: string; const aContentType: string = 'application/json'): string; overload;
procedure Patch(const aURL: string; const aSource: TStream; const aResponseContent: TStream); overload;

パラメータ

名前	タイプ	説明
`aURL`	`const string`	リクエストの送信先リソースの絶対 URL。
`aData`	`const string`	サーバーに送信される部分更新を含むリクエストボディ。
`aContentType`	`const string`	content-type ヘッダーの値。デフォルトは `application/json` です。
`aSource`	`TStream`	リクエストボディとして送信されるコンテンツのストリーム（ストリームオーバーロードのみ）。
`aResponseContent`	`TStream`	生のレスポンスボディを受け取るストリーム（ストリームオーバーロードのみ）。

戻り値

サーバーから受信したレスポンスボディ（文字列としてデコード済み）。ストリームオーバーロードは代わりに aResponseContent にボディを書き込みます。（string）

解説

Patch はリソースへの部分更新を適用し、完全な HTTP/3 レスポンスが受信されるまで呼び出しスレッドをブロックします。リソースを置き換える Put とは異なり、PATCH は変更点のみを送信します。文字列ボディを送信するには最初のオーバーロードを使用し、TStream からボディを送信して別のストリームに返信を書き込むにはストリームオーバーロードを使用してください。ノンブロッキングリクエストには PatchAsync を使用してください。返信は OnResponse で通知されます。

使用例


vResponse := oClient.Patch('https://api.example.com/v1/users/42', '{"name":"john"}');

メソッドに戻る