Patch Méthode

Surcharge 1

Syntaxe

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

Paramètres

Nom	Type	Description
aURL	const string	URL absolue de la ressource à mettre à jour partiellement.
aSource	const TStream	Flux contenant le document de patch (par exemple un corps JSON Patch ou JSON Merge Patch).

Valeur de retour

Corps de réponse retourné par le serveur décodé en chaîne. (string)

Remarques

Contrairement à PUT, PATCH n'envoie que les champs qui doivent changer. Assurez-vous que Request.ContentType correspond au format de patch attendu par le serveur (par ex. application/json-patch+json ou application/merge-patch+json).

Exemple

oBody := TStringStream.Create('{"email":"new@example.com"}');
try
  oClient.Request.ContentType := 'application/merge-patch+json';
  vResponse := oClient.Patch('https://api.example.com/users/42', oBody);
finally
  oBody.Free;
end;

Surcharge 2

Syntaxe

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

Paramètres

Nom	Type	Description
aURL	const string	URL absolue de la ressource à mettre à jour partiellement.
aSource	const TStream	Flux contenant la charge utile de patch.
aResponseContent	const TStream	Flux qui capture la réponse brute du serveur.

Remarques

Variante entièrement en streaming. Adaptée lorsque le document de patch ou la représentation de la réponse est suffisamment volumineuse pour qu'un aller-retour en chaîne soit peu économique.

Exemple

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