TsgcHTTP3Client › Metodi › Patch
Invia una richiesta HTTP/3 PATCH sincrona con un payload nel corpo e restituisce il corpo della risposta.
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;
| Nome | Tipo | Descrizione |
|---|---|---|
aURL | const string | URL assoluto della risorsa a cui viene inviata la richiesta. |
aData | const string | Corpo della richiesta con l'aggiornamento parziale inviato al server. |
aContentType | const string | Valore dell'header content-type. Il valore predefinito è application/json. |
aSource | TStream | Stream il cui contenuto viene inviato come corpo della richiesta (solo overload con stream). |
aResponseContent | TStream | Stream che riceve il corpo grezzo della risposta (solo overload con stream). |
Corpo della risposta ricevuto dal server, decodificato come stringa. L'overload con stream scrive invece il corpo in aResponseContent. (string)
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.
vResponse := oClient.Patch('https://api.example.com/v1/users/42', '{"name":"john"}');