TsgcHTTP2ClientMétodos › Options

Options Method

Realiza uma requisição HTTP/2 OPTIONS síncrona para descobrir as opções de comunicação de um recurso.

Overloads

Overload 1

Sintaxe

function Options(const aURL: string): string;

Parâmetros

NameTypeDescrição
aURLconst stringURL absoluta do recurso cujas capacidades estão sendo consultadas, ou * para consultar o servidor como um todo.

Valor de retorno

Corpo da resposta retornado pelo servidor como uma string; a informação útil geralmente está nos cabeçalhos da resposta. (string)

Observações

O OPTIONS é comumente utilizado por navegadores para preflight CORS e por clientes para sondar quais métodos são aceitos. Inspecione Request.Headers após a chamada para ler os cabeçalhos allow, access-control-allow-* e relacionados.

Exemplo

vResponse := oClient.Options('https://api.example.com/v1/users');

Sobrecarga 2

Sintaxe

procedure Options(Const aURL: string; const aResponseContent: TStream);

Parâmetros

NameTypeDescrição
aURLconst stringURL absoluta do recurso sendo interrogado.
aResponseContentconst TStreamStream de propriedade do chamador que recebe o corpo da resposta, se o servidor retornar algum.

Observações

Variante baseada em stream de OPTIONS. Use-a quando o payload da resposta deve ser roteado para um TStream arbitrário em vez de ser materializado como uma string.

Exemplo

oOut := TMemoryStream.Create;
try
  oClient.Options('https://api.example.com/v1/users', oOut);
finally
  oOut.Free;
end;

Voltar para Métodos