For the complete documentation index, see llms.txt. This page is also available as Markdown.

Request-Header

Request-Header sind Key-Value-Paare, die bei einem HTTP-Request übermittelt werden. Header können entweder für die gesamte API oder für einzelne Endpunkte festgelegt werden.

Es gibt eine Unterscheidung zwischen gewöhnlichen und geheimen Headern. Geheime Header werden mit zusätzlicher Verschlüsselung in der Datenbank gespeichert. In Workflow- und API-Protokollen wird der Wert eines geheimen Headers nicht angezeigt; stattdessen wird nur **** dargestellt, um darauf hinzuweisen, dass es sich um einen geheimen Header handelt.

Wird ein Header sowohl für die gesamte API als auch für einen Endpunkt erstellt, überschreibt der Header des Endpunkts den Header der API.

Erstellen eines Headers

Um einen neuen Header zu erstellen, klicken Sie auf + Header hinzufügen oder + Geheimen Header hinzufügen.

Header hinzufügen

Ein Header besteht aus einem Namen und einem Wert, wofür Eingabefelder bereitstehen:

Neuen Header erstellen

Löschen eines Headers

Mit einem Klick auf das Icon kann ein Header wieder gelöscht werden.

Header für das Herunterladen von Dateien

Der Parameter "Request-Body" des Plugins API-Endpunkt aufrufen kann in eine Variable vom Typ file geschrieben werden. Dies ist dann sinnvoll, wenn der Endpunkt eine Datei herunterladen soll, zum Beispiel ein Bild im PNG-Format. Damit der Download korrekt funktioniert, muss ein Accept Header gesetzt werden. Der Accept Header gibt an, welche Datei-Typ Robot bei diesem Endpunkt akzeptiert. Der Server, zu dem der Request geschickt wird, liefer im Normalfall nur dann eine Response, wenn sie zum Accept Header passt.

Beispiel: Download eines PNG-Bildes

Wenn der Endpunkt eine Datei im PNG-Format herunterladen soll, muss der Accept Header auf den Wert image/png gesetzt werden. Dies teilt dem Server mit, dass ein Bild im PNG-Format gewünscht ist. Wenn der Server das Bild in diesem Format zur Verfügung stellen kann, wird die Response den Header Content-Type: image/png haben und im Response-Body wird das Bild sein.

Unterstützte Dateiformate für den Download

Folgende Mime-Types werden für den Download aktuell unterstützt:

  • image/* : Alle Bildformate

  • audio/* : Alle Audioformate

  • video/* : Alle Videoformate

  • application/octet-stream : Allgemeiner Binärdatentyp der verwendet wird, wenn der genaue Dateityp unbekannt ist

  • application/pdf : PDF-Dokumente

Zuletzt aktualisiert