TsgcHTTP3Client › Methoden › Delete
Sendet eine synchrone HTTP/3-DELETE-Anfrage, um die Zielressource zu entfernen.
function Delete(const aURL: string): string; overload;
| Name | Typ | Beschreibung |
|---|---|---|
aURL | const string | Absolute URL der Zielressource. |
Vom Server empfangener Antworttext, als String dekodiert. (string)
procedure Delete(const aURL: string;
const aResponseContent: TStream); overload;
| Name | Typ | Beschreibung |
|---|---|---|
aURL | const string | Absolute URL der Zielressource. |
aResponseContent | TStream | Stream, der den Antwort-Body empfängt. |
Keine. Der Antwort-Body wird nach aResponseContent geschrieben.
Der Aufruf blockiert den aufrufenden Thread, bis die vollständige Antwort empfangen wurde. Wenn der Client noch nicht verbunden ist, wird die URL verwendet, um zuerst die QUIC-Verbindung zu öffnen. Für eine nicht-blockierende Anfrage verwenden Sie DeleteAsync, das die Antwort über OnResponse liefert.
DELETE fordert den Server auf, die Zielressource zu entfernen, und trägt keinen Request-Body. Viele APIs antworten mit 204 No Content und einem leeren Body, prüfen Sie daher den Statuscode statt der zurückgegebenen Zeichenfolge, um zu entscheiden, ob der Aufruf erfolgreich war. Lesen Sie den Status aus OnResponse oder verwenden Sie Head, um zu bestätigen, dass die Ressource entfernt wurde.
vResponse := oClient.Delete('https://api.example.com/v1/users/1');