> For the complete documentation index, see [llms.txt](https://help.aiaibot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aiaibot.com/robot/api-spezifikationen/request-header.md).

# 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.

{% hint style="warning" %}
Request-Header sind case-insensitiv; die Gross- und Kleinschreibung ist nicht relevant.
{% endhint %}

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*.

<figure><img src="/files/Gxw7o9lJQXSOh1a0L7xL" alt="" width="562"><figcaption><p>Header hinzufügen</p></figcaption></figure>

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

<figure><img src="/files/yx4STuCruKPiANIxWn3W" alt="" width="563"><figcaption><p>Neuen Header erstellen</p></figcaption></figure>

{% hint style="warning" %}
Überprüfen Sie den Wert eines geheimen Headers bei der Eingabe genau, da dieser nach dem Speichern nicht wieder eingesehen werden kann.
{% endhint %}

## Löschen eines Headers

Mit einem Klick auf das <img src="/files/SI4soLGxuw1dVUiu0Wyz" alt="" data-size="line"> Icon kann ein Header wieder gelöscht werden.

## Header für das Herunterladen von Dateien

Der Parameter "Request-Body" des Plugins [API-Endpunkt aufrufen](/robot/plugins/rest-apis-und-json/api-endpunkt-aufrufen.md) 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