TsgcHTTP3Client › Metodi › Patch

Patch Method

Invia una richiesta HTTP/3 PATCH sincrona con un payload nel corpo e restituisce il corpo della risposta.

Sintassi

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;

Parametri

NomeTipoDescrizione
aURLconst stringURL assoluto della risorsa a cui viene inviata la richiesta.
aDataconst stringCorpo della richiesta con l'aggiornamento parziale inviato al server.
aContentTypeconst stringValore dell'header content-type. Il valore predefinito è application/json.
aSourceTStreamStream il cui contenuto viene inviato come corpo della richiesta (solo overload con stream).
aResponseContentTStreamStream che riceve il corpo grezzo della risposta (solo overload con stream).

Valore restituito

Corpo della risposta ricevuto dal server, decodificato come stringa. L'overload con stream scrive invece il corpo in aResponseContent. (string)

Note

Patch applica un aggiornamento parziale alla risorsa e blocca il thread chiamante finché la risposta HTTP/3 completa non è stata ricevuta. A differenza di Put, che sostituisce la risorsa, PATCH invia solo le modifiche. Utilizzare il primo overload per inviare un corpo come stringa e l'overload con stream per inviare il corpo da un TStream e scrivere la risposta su un altro stream. Per una richiesta non bloccante utilizzare PatchAsync, che consegna la risposta su OnResponse.

Esempio


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

Torna ai Metodi