TsgcHTTP3Client › Méthodes › Patch

Patch Méthode

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

Syntaxe

function Patch(const aURL: string; const aData: string; const aContentType: string = 'application/json'): string; overload;
procedure Patch(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 contenant la mise à jour partielle envoyée 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

Patch applique une mise à jour partielle à la ressource et bloque le thread appelant jusqu'à ce que la réponse HTTP/3 complète ait été reçue. Contrairement à Put, qui remplace la ressource, PATCH n'envoie que les modifications. Utilisez la première surcharge pour envoyer un corps de type chaîne et la surcharge flux pour envoyer le corps depuis un TStream et écrire la réponse dans un autre flux. Pour une requête non bloquante, utilisez PatchAsync, qui délivre la réponse sur OnResponse.

Exemple


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

Retour aux méthodes