TsgcHTTP3Client › Méthodes › Put

Put Méthode

Envoie une requête HTTP/3 PUT synchrone avec un corps de message et retourne le corps de la réponse.

Syntaxe

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;

Paramètres

NomTypeDescription
aURL const stringURL absolue de la ressource à laquelle la requête est envoyée.
aData const stringCorps de la requête envoyé au serveur.
aContentTypeconst stringValeur de l'en-tête content-type. Par défaut : application/json.
aSourceTStream Flux dont le contenu est envoyé comme corps de la requête (surcharge flux uniquement).
aResponseContentTStream Flux qui reçoit le corps brut de la réponse (surcharge flux uniquement).

Valeur de retour

Corps de la réponse reçu du serveur, décodé sous forme de chaîne. La surcharge flux écrit le corps dans aResponseContent à la place. (string)

Remarques

Put bloque le thread appelant jusqu'à ce que la réponse HTTP/3 complète ait été reçue. Utilisez la première surcharge pour envoyer un corps de type chaîne, en définissant aContentType pour correspondre à la charge utile ; utilisez la surcharge flux pour envoyer le corps de la requête depuis un TStream et écrire la réponse dans un autre flux. Pour une requête non bloquante, utilisez PutAsync, qui délivre la réponse sur OnResponse.

Exemple


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

Retour aux méthodes