> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/de/form-management/security/security-items/http-security-function.md).

# HTTP-Funktion

## 🔌 Was ist eine HTTP-Funktion?

Die HTTP-Sicherheitsfunktion ermöglicht es Ihnen, ngSurvey einfach mit eigenen Remote-HTTP-REST-basierten Funktionen zu erweitern.

Mit der HTTP-Sicherheitsfunktion können Sie eine benutzerdefinierte Benutzeroberfläche einrichten, um Daten vom Befragten zu erfassen, bevor die Umfrage angezeigt wird, diese Daten als einfaches JSON-Objekt an einen bestimmten HTTP-REST-Endpunkt zu senden, beliebige geschäftslogische Verarbeitung der Daten vorzunehmen und ein neues JSON-Objekt von Ihrem HTTP-Endpunkt zurückzugeben, das zusammen mit den Antworten des Befragten gespeichert wird und überall in der Umfrage mithilfe der ngSurvey Piping-Funktionen verwendet werden kann.

## ☁️ Was wird gesendet und empfangen? 

Das Objekt, das von ngSurvey an Ihren HTTP-Endpunkt gesendet wird, ist ein einfaches JSON-formatiertes Objekt wie folgt 

```javascript
{
 properynamefromyouruserinterface1 : 'value', 
 properynamefromyouruserinterface2 : 'value'
}
```

Zusätzlich zu den in der Benutzeroberfläche vom Befragten eingegebenen Werten sendet ngSurvey folgende zusätzliche Eigenschaften an den Endpunkt:

```javascript
{
 ngsSurveyId : 'abcd' // ID der Umfrage, 
 ngsRemoteip : '127.0.0.1' // IP des Befragten
}
```

Vom HTTP-Endpunkt zurückgegebenes Objekt muss als JSON-Objektstruktur formatiert sein, wie unten gezeigt; Sie können beliebig viele Eigenschaften zurücksenden.

```javascript
{
yourproperty1:'value', 
yourproperty2:'value'
}
```

{% hint style="info" %}
🧙 Werte, die von Ihrem HTTP-Endpunkt zurückgegeben werden, können [verwendet werden (piped)](/de/form-management/form-designer/piping/text-data-piping.md) überall in Ihren Umfragetexten oder Antworten mit folgendem Pipe-Format \_\_yourproperty1\_\_ eingefügt werden   
{% endhint %}

## 🔅 HTTP-Funktions-Eigenschaften

* **`HTTP-Endpunkt-URL`** muss die HTTP-URL sein, die die in der Benutzeroberfläche eingegebenen Daten empfängt. ngSurvey sendet die Daten entweder als JSON-Objekt, wenn auf POST eingestellt, oder als Schlüssel/Werte, die an die Endpunkt-URL angehängt werden.
* **`Abfragewerte übertragen`** wenn aktiviert, leitet ngSurvey alle Querystring-Schlüssel/Werte weiter, die in der Umfrage-URL eingerichtet wurden.
* **`Beim Laden aufrufen`** Die HTTP-Funktion wird sofort aufgerufen, sobald das Sicherheits-Element geladen ist, ohne die Benutzeroberfläche anzuzeigen. Dies ist nützlich, wenn Sie den Endpunkt mithilfe von Querystring-Parametern verwenden möchten, ohne Informationen über die Benutzeroberfläche abzufragen.
* **`Gesichert` l**Erlaubt Ihnen, ein JWT-Token einzurichten, das zur Autorisierung des HTTP-Endpunkts verwendet wird.
* **`Eigenschaftsname für eindeutigen Wert`** ist der Eigenschaftenname aus dem vom HTTP-Endpunkt zurückgegebenen Objekt, der als "Primärschlüssel" verwendet wird, um die zurückgegebenen Daten eindeutig zu identifizieren. Dieser eindeutige Schlüssel wird verwendet, um doppelte Einträge zu verhindern und Save-/Resume-Funktionen zu ermöglichen, wenn das HTTP-Sicherheits-Element als Schlüsselanbieter festgelegt ist.
* **`Laden`** Kurze Nachricht, die während des Aufrufs beim Laden angezeigt wird. 
* **`Einführungsnachricht`** Kurze Nachricht, die über der Benutzeroberfläche angezeigt wird.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ngsurvey.com/de/form-management/security/security-items/http-security-function.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.