TsgcHTTP3Client › Metodi › Put

Put Method

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

Sintassi

function Put(const aURL: string; const aData: string; const aContentType: string = 'application/json'): string; overload;
procedure Put(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 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

Put blocca il thread chiamante finché la risposta HTTP/3 completa non è stata ricevuta. Utilizzare il primo overload per inviare un corpo come stringa, impostando aContentType in modo che corrisponda al payload; utilizzare l'overload con stream per inviare il corpo della richiesta da un TStream e scrivere la risposta su un altro stream. Per una richiesta non bloccante utilizzare PutAsync, che consegna la risposta su OnResponse.

Esempio


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

Torna ai Metodi