# 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FnoHWlazSY6MlRyeD4LIH%2Fapi-header-01.png?alt=media&#x26;token=747790c8-60b0-424f-a75d-414812001518" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FnJZ4WdaSxXwbvkUJWlvR%2Fapi-header-02.png?alt=media&#x26;token=c52add6f-2bd2-4648-b48c-b39fdc3fd1c0" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FdzsBawffNqy9Y0NLP5CD%2Fapi-header-03.png?alt=media&#x26;token=3d8dcf78-85a1-4bbf-b355-3ab4b5b8c77b" alt="" data-size="line"> Icon kann ein Header wieder gelöscht werden.