TsgcHTTP3Client › Métodos › Put

Put Método

Envia uma requisição HTTP/3 PUT síncrona com um corpo de dados e retorna o corpo da resposta.

Sintaxe

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

NameTypeDescrição
aURLconst stringURL absoluta do recurso ao qual a requisição é enviada.
aDataconst stringCorpo da requisição enviado 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

Put bloqueia o thread chamador até que a resposta HTTP/3 completa seja recebida. Use a primeira sobrecarga para enviar um corpo em string, definindo aContentType para corresponder ao payload; use a sobrecarga de stream para enviar o corpo da requisição a partir de um TStream e escrever a resposta em outro stream. Para uma requisição não bloqueante, use PutAsync, que entrega a resposta em OnResponse.

Exemplo


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

Voltar para Métodos