Put Méthode

Surcharge 1

Syntaxe

function Put(const aURL: string; const aSource: TStream): string;

Paramètres

Nom	Type	Description
aURL	const string	URL absolue identifiant la ressource qui sera créée ou remplacée.
aSource	const TStream	Flux fournissant la représentation complète de la ressource à stocker.

Valeur de retour

Corps de la réponse reçu du serveur décodé sous forme de chaîne. (string)

Remarques

PUT est idempotent : l'appeler à plusieurs reprises avec le même corps donne le même état de ressource sur le serveur. Cette surcharge est adaptée aux charges utiles JSON/texte dont la réponse textuelle peut être consommée comme une chaîne.

Exemple

oBody := TStringStream.Create('{"status":"active"}');
try
  oClient.Request.ContentType := 'application/json';
  vResponse := oClient.Put('https://api.example.com/users/42', oBody);
finally
  oBody.Free;
end;

Surcharge 2

Syntaxe

procedure Put(const aURL: string; const aSource: TStream; const aResponseContent: TStream);

Paramètres

Nom	Type	Description
aURL	const string	URL absolue identifiant la ressource à créer ou remplacer.
aSource	const TStream	Flux fournissant les octets de ressource à téléverser.
aResponseContent	const TStream	Flux qui capture le corps brut de la réponse du serveur.

Remarques

Variante flux vers flux recommandée pour les téléversements de ressources binaires, comme les remplacement d'images ou de fichiers, où la requête et la réponse sont mieux gérées sans conversion en chaîne.

Exemple

oIn := TFileStream.Create('avatar.png', fmOpenRead);
oOut := TMemoryStream.Create;
try
  oClient.Put('https://api.example.com/users/42/avatar', oIn, oOut);
finally
  oOut.Free;
  oIn.Free;
end;