TsgcHTTP3Client › Métodos › Patch

Patch Method

Envia uma requisição HTTP/3 PATCH síncrona com um payload no corpo e retorna o corpo da resposta.

Sintaxe

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

NameTypeDescrição
aURLconst stringURL absoluta do recurso ao qual a requisição é enviada.
aDataconst stringCorpo da requisição com a atualização parcial enviada ao servidor.
aContentTypeconst stringValor do header content-type. Padrão: application/json.
aSourceTStreamStream cujo conteúdo é enviado como corpo da requisição (somente na sobrecarga de stream).
aResponseContentTStreamStream que recebe o corpo bruto da resposta (apenas sobrecarga de stream).

Valor de retorno

Corpo da resposta recebido do servidor, decodificado como string. A sobrecarga de stream grava o corpo em aResponseContent. (string)

Observações

Patch aplica uma atualização parcial ao recurso e bloqueia o thread chamador até que a resposta HTTP/3 completa seja recebida. Ao contrário de Put, que substitui o recurso, PATCH envia apenas as alterações. Use a primeira sobrecarga para enviar um corpo em string e a sobrecarga de stream para enviar o corpo a partir de um TStream e gravar a resposta em outro stream. Para uma requisição não bloqueante, use PatchAsync, que entrega a resposta em OnResponse.

Exemplo


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

Voltar para Métodos