TsgcHTTP3Client › Métodos › Put

Put Método

Envía una solicitud HTTP/3 PUT síncrona con una carga útil en el cuerpo y devuelve el cuerpo de la respuesta.

Sintaxis

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;

Parámetros

NombreTipoDescripción
aURLconst stringURL absoluta del recurso al que se envía la solicitud.
aDataconst stringCuerpo de la solicitud enviado al servidor.
aContentTypeconst stringValor de la cabecera content-type. Su valor predeterminado es application/json.
aSourceTStreamStream cuyo contenido se envía como cuerpo de la solicitud (solo en la sobrecarga de stream).
aResponseContentTStreamStream que recibe el cuerpo de la respuesta sin procesar (solo en la sobrecarga de stream).

Valor de Retorno

Cuerpo de la respuesta recibido del servidor, decodificado como una cadena. La sobrecarga de stream escribe el cuerpo en aResponseContent en su lugar. (string)

Observaciones

Put bloquea el hilo llamador hasta que se ha recibido la respuesta HTTP/3 completa. Use la primera sobrecarga para enviar un cuerpo de cadena, estableciendo aContentType para que coincida con el payload; use la sobrecarga de stream para enviar el cuerpo de la solicitud desde un TStream y escribir la respuesta en otro stream. Para una solicitud no bloqueante use PutAsync, que entrega la respuesta en OnResponse.

Ejemplo


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

Volver a Métodos