# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aiaibot.com/robot/api-spezifikationen/request-header.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.