TsgcHTTP3Client › Methoden › Patch

Patch Methode

Verstuurt een synchroon HTTP/3 PATCH-verzoek met een body-payload en retourneert de antwoordbody.

Syntaxis

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;

Parameters

NaamTypeBeschrijving
aURLconst stringAbsolute URL van de resource waarnaar het verzoek wordt verstuurd.
aDataconst stringVerzoekbody met de gedeeltelijke update die naar de server wordt verstuurd.
aContentTypeconst stringWaarde van de content-type-header. Standaard application/json.
aSourceTStreamStream waarvan de inhoud als verzoekbody wordt verstuurd (alleen stream-overload).
aResponseContentTStreamStream die de ruwe antwoordtekst ontvangt (alleen stream-overbelasting).

Retourwaarde

Antwoordbody ontvangen van de server, gedecodeerd als een string. De stream-overload schrijft de body in plaats daarvan naar aResponseContent. (string)

Opmerkingen

Patch past een gedeeltelijke update toe op de resource en blokkeert de aanroepende thread totdat het volledige HTTP/3-antwoord is ontvangen. In tegenstelling tot Put, dat de resource vervangt, verstuurt PATCH alleen de wijzigingen. Gebruik de eerste overload om een stringbody te versturen en de stream-overload om de body vanuit een TStream te versturen en het antwoord naar een andere stream te schrijven. Gebruik voor een niet-blokkerende aanvraag PatchAsync, dat het antwoord levert via OnResponse.

Voorbeeld


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

Terug naar methoden