TsgcHTTP2ClientMéthodes › Options

Options Méthode

Effectue une requête HTTP/2 OPTIONS synchrone pour découvrir les options de communication d'une ressource.

Surcharges

Surcharge 1

Syntaxe

function Options(const aURL: string): string;

Paramètres

NomTypeDescription
aURL const stringURL absolue de la ressource dont les capacités sont interrogées, ou * pour interroger le serveur dans son ensemble.

Valeur de retour

Corps de réponse retourné par le serveur sous forme de chaîne ; les informations utiles se trouvent généralement dans les en-têtes de réponse. (string)

Remarques

OPTIONS est couramment utilisé par les navigateurs pour le contrôle en amont CORS et par les clients pour sonder les méthodes acceptées. Inspectez Request.Headers après l'appel pour lire les en-têtes allow, access-control-allow-* et connexes.

Exemple

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

Surcharge 2

Syntaxe

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

Paramètres

NomTypeDescription
aURL const stringURL absolue de la ressource interrogée.
aResponseContentconst TStream Flux appartenant à l'appelant qui reçoit le corps de la réponse, si le serveur en renvoie un.

Remarques

Variante basée sur les flux de OPTIONS. À utiliser lorsque la charge utile de la réponse doit être routée vers un TStream arbitraire plutôt que matérialisée en tant que chaîne.

Exemple

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

Retour aux méthodes