TsgcHTTP2ClientMetodi › Options

Options Metodo

Esegue una richiesta OPTIONS HTTP/2 sincrona per scoprire le opzioni di comunicazione di una risorsa.

Overload

Overload 1

Sintassi

function Options(const aURL: string): string;

Parametri

NomeTipoDescrizione
aURLconst stringURL assoluto della risorsa di cui vengono interrogate le capacità, oppure * per interrogare il server nel suo complesso.

Valore restituito

Corpo della risposta restituito dal server come stringa; le informazioni utili si trovano di solito nelle intestazioni della risposta. (string)

Note

OPTIONS viene comunemente utilizzato dai browser per il preflight CORS e dai client per verificare quali metodi sono accettati. Ispezionare Request.Headers dopo la chiamata per leggere le intestazioni allow, access-control-allow-* e correlate.

Esempio

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

Sovraccarico 2

Sintassi

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

Parametri

NomeTipoDescrizione
aURLconst stringURL assoluto della risorsa interrogata.
aResponseContentconst TStreamStream di proprietà del chiamante che riceve il corpo della risposta, se il server ne restituisce uno.

Note

Variante basata su stream di OPTIONS. Utilizzarla quando il payload della risposta deve essere indirizzato a un TStream arbitrario anziché materializzato come stringa.

Esempio

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

Torna ai Metodi