HTTP-Anfragemethoden

Letzte Aktualisierung: 16. Januar 2025
  • Themen:

Wenn Sie einen API-Aufruf in einem Modul konfigurieren, müssen Sie die HTTP-Anfragemethode auswählen. In diesem Artikel werden die verfügbaren Methoden beschrieben und warum Sie jede auswählen sollten.

HTTP-Methoden

Verwenden Sie eine der folgenden HTTP-Methoden.

  • GET: Ruft Daten von einem Webserver basierend auf Ihren Parametern ab. GET fordert eine Darstellung der angegebenen Ressource an und erhält bei Erfolg eine 200 OK-Antwortnachricht mit dem angeforderten Inhalt.
  • POST: Sendet Daten basierend auf Ihren Parametern an einen Webserver. POST Anfragen enthalten Aktionen wie das Hochladen einer Datei. Mehrere POST können zu einem anderen Ergebnis führen als ein einzelnes POST. Gehen Sie daher vorsichtig vor, wenn Sie versehentlich mehrere POST senden. Wenn eine POST erfolgreich ist, erhalten Sie eine 200 OK.
  • PUT: Sendet Daten anhand Ihrer Parameter an einen Speicherort im Webserver. PUT Anfragen enthalten Aktionen wie das Hochladen einer Datei. Der Unterschied zwischen einem PUT und POST besteht darin, dass PUT idempotent ist, d. h., dass das Ergebnis eines einzelnen erfolgreichen PUT dasselbe ist wie viele identische PUT. Bei erfolgreicher PUT erhalten Sie eine 200-fache Antwortnachricht (normalerweise 201 oder 204).
  • PATCH: (Für einige API-Aufrufmodule nicht verfügbar) Wendet basierend auf Ihren Parametern partielle Änderungen an einer Ressource auf einem Webserver an. PATCH ist nicht idempotent, was bedeutet, dass das Ergebnis mehrerer PATCH unbeabsichtigte Folgen haben könnte. Wenn eine PATCH erfolgreich ist, erhalten Sie eine 200-fache Antwortnachricht (normalerweise 204).
  • DELETE: Löscht die angegebene Ressource vom Webserver basierend auf Ihren Parametern (wenn die Ressource vorhanden ist). Wenn eine DELETE erfolgreich ist, erhalten Sie eine 200-OK-Antwortnachricht.
Vorherige SeiteIterator-Module
Nächste SeiteSchlüssel

Workfront