TsgcHTTP3Client › Métodos › Patch

Patch Método

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

Sintaxis

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;

Parámetros

NombreTipoDescripción
aURLconst stringURL absoluta del recurso al que se envía la solicitud.
aDataconst stringCuerpo de la solicitud con la actualización parcial enviada 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

Patch aplica una actualización parcial al recurso y bloquea el hilo llamador hasta que se ha recibido la respuesta HTTP/3 completa. A diferencia de Put, que reemplaza el recurso, PATCH envía solo los cambios. Use la primera sobrecarga para enviar un cuerpo de cadena y la sobrecarga de stream para enviar el cuerpo desde un TStream y escribir la respuesta en otro stream. Para una solicitud no bloqueante use PatchAsync, que entrega la respuesta en OnResponse.

Ejemplo


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

Volver a Métodos