> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/de/api/configuration.md).

# API-Konfiguration

Diese Seite beschreibt die Dastra-REST-API: ihre Adresse, ihre Nutzungsgrenzen und den Umgang mit benutzerdefinierten Feldern und Tags. Wie Sie einen Schlüssel erhalten und die API aufrufen, lesen Sie unter [Authentifizierung](https://doc.dastra.eu/de/api/authentication.md).

### APIs in Dastra konfigurieren

API steht für ***Application Programming Interface*** (Programmierschnittstelle).

APIs ermöglichen es, die Dastra-Plattform mit anderen externen Tools zu verbinden.

Die Möglichkeiten sind vielfältig: Verbindung mit einer CRM-Software zur automatisierten Übernahme von Beteiligten, Synchronisation eines Tools zur Verwaltung von Betroffenenrechten mit dem Dastra-Modul usw.

Dastra basiert auf dem Standard **API-Rest** und insbesondere auf den folgenden HTTP-Anfragen:

| URI                                                                | GET                                                                                 | POST                                                                                                                                                                                                                                               | PUT                                                                                                                                                                                  | PATCH                                                                                                                                                                                                                 | DELETE                                                                      |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Sammlungsressource, wie `http://api.beispiel.com/collection/`      | *Ruft* die URIs der Mitgliedsressourcen der Sammlungsressource im Antwortkörper ab. | *Erstellt* eine Mitgliedsressource in der Sammlungsressource unter Verwendung der Anweisungen des Anfragekörpers. Die URI der erstellten Mitgliedsressource wird *automatisch zugewiesen* und im *Location*-Header-Feld der Antwort zurückgegeben. | *Ersetzt* alle Darstellungen der Mitgliedsressourcen der Sammlungsressource durch die Darstellung im Anfragekörper oder *erstellt* die Sammlungsressource, wenn sie nicht existiert. | *Aktualisiert* alle Darstellungen der Mitgliedsressourcen der Sammlungsressource unter Verwendung der Anweisungen des Anfragekörpers oder *erstellt gegebenenfalls* die Sammlungsressource, wenn sie nicht existiert. | *Löscht* alle Darstellungen der Mitgliedsressourcen der Sammlungsressource. |
| Mitgliedsressource, wie `http://api.beispiel.com/collection/item3` | *Ruft* eine Darstellung der Mitgliedsressource im Antwortkörper ab.                 | *Erstellt* eine Mitgliedsressource in der Mitgliedsressource unter Verwendung der Anweisungen des Anfragekörpers. Die URI der erstellten Mitgliedsressource wird *automatisch zugewiesen* und im *Location*-Header-Feld der Antwort zurückgegeben. | *Ersetzt* alle Darstellungen der Mitgliedsressource oder *erstellt* die Mitgliedsressource, wenn sie nicht existiert, durch die Darstellung im Anfragekörper.                        | *Aktualisiert* alle Darstellungen der Mitgliedsressource oder *erstellt gegebenenfalls* die Mitgliedsressource, wenn sie nicht existiert, unter Verwendung der Anweisungen des Anfragekörpers.                        | *Löscht* alle Darstellungen der Mitgliedsressource.                         |

Quelle: [*Wikipedia*](https://de.wikipedia.org/wiki/Representational_State_Transfer)

### Adresse und Versionen

Die Dastra-API ist unter `https://api.dastra.eu` erreichbar. Die Routen sind versioniert und beginnen mit `/v1/`.

* Die Routen eines Mandanten enthalten seine Kennung: `/v1/ws/{workspaceId}/{resource}`, zum Beispiel `/v1/ws/{workspaceId}/DataSubjectRequests`. Die Kennungen stehen im Tab **tenantId & workspaceId** der Seite **API-Schlüssel & MCP**.
* Die Routen, die die gesamte Organisation betreffen, haben keine Mandantenkennung, zum Beispiel `/v1/Workspaces`.

### Referenz der Endpunkte

Die Liste der Endpunkte mit ihren Parametern und Datenmodellen wird im OpenAPI-Format veröffentlicht:

* die Swagger-Oberfläche: <https://api.dastra.eu/swagger/index.html>;
* die OpenAPI-Definition als JSON: <https://api.dastra.eu/api/v1/dastra.json>.

Sie enthält nur die öffentlichen Endpunkte der API. Das Compliance-Modul (Frameworks, Kontrollen, Tests, Audits) hat eine eigene API, deren Routen mit `/v1/compliance/` beginnen: <https://api.dastra.eu/v1/compliance/swagger/index.html>.

Die Referenzen stehen auch auf [dastra.readme.io](https://dastra.readme.io) bereit. Ein vollständiges Beispiel finden Sie unter [API-Anwendungsfälle](https://doc.dastra.eu/de/api/use-cases.md).

### Einschränkungen

Anfragen werden pro Nutzer gezählt, also pro Inhaber des API-Schlüssels, und zwar nach ihrem Typ:

| Anfragetyp                                   | Limit                                             |
| -------------------------------------------- | ------------------------------------------------- |
| Lesen (`GET`)                                | 500 pro Minute und 10.000 pro 10-Minuten-Zeitraum |
| Schreiben (`POST`, `PUT`, `PATCH`, `DELETE`) | 75 pro Minute und 1.000 pro 10-Minuten-Zeitraum   |
| Sensible Endpunkte                           | 5 pro 5-Minuten-Zeitraum                          |

Einige Endpunkte, etwa die des KI-Assistenten, haben strengere Limits.

Bei Überschreitung eines Limits antwortet die API mit dem HTTP-Status 429 und einem Header `Retry-After`, der in Sekunden die Wartezeit bis zum nächsten Versuch angibt. Warten Sie diese Zeit ab, bevor Sie die Anfrage erneut senden.

Um Ihre Zähler zu prüfen, rufen Sie `GET https://api.dastra.eu/rate-limiting-state` auf.

Die Sicherheitsoptionen, etwa die [IP-Filterung](https://doc.dastra.eu/de/features/settings/ip-filtering.md), gelten nicht für Aufrufe mit einem API-Schlüssel.

### Bereitstellung benutzerdefinierter Felder in der Dastra-API

In Dastra ist es möglich, [benutzerdefinierte Felder](https://doc.dastra.eu/de/features/general/custom-fields.md), die in Ihrem Dastra-Mandanten erstellt wurden, über die API bereitzustellen.

Benutzerdefinierte Felder sind für jeden Mandanten spezifisch. Um sie in der Dastra-API zu berücksichtigen, legen Sie zunächst den **Namen der Variablen (Slug)** in der Definition des benutzerdefinierten Feldes fest:

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-5f2be64d6fb84314a228c98224892e1140800fae%2Fgeneral-custom-fields-4.png?alt=media" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/78pjV82cr1qqv9TqE6RM" %}
[Benutzerdefinierte Felder](https://doc.dastra.eu/de/features/general/custom-fields.md)
{% endcontent-ref %}

Die meisten über die API bearbeitbaren Entitäten stellen eine Eigenschaft `customFields` bereit, die Sie ändern können.

Wenn Sie in Ihrem Mandanten die folgenden Felder definieren:

* `my_string_field`: ein Feld vom Typ **Text**;
* `my_boolean_field`: ein Feld vom Typ **Boolean**;
* `my_numeric_field`: ein Feld vom Typ **Zahl (ganze Zahl)**;
* `my_checkbox_field`: ein Feld vom Typ **Kontrollkästchen**.

können Sie sie so ändern:

```json
{
  "label": "Google Analytics 4",
  "customFields": {
    "my_string_field": "Value of my field",
    "my_boolean_field": true,
    "my_numeric_field": 1,
    "my_checkbox_field": ["Apple", "Banana"]
  }
}
```

Bei einem Feld vom Typ **Kontrollkästchen** ist der Wert die Liste der Bezeichnungen der angekreuzten Antworten.

### Der Fall der Tags

Um Tags mit einer Entität zu verknüpfen, rufen Sie zunächst die vorhandenen Tags mit `GET /v1/ws/{workspaceId}/Tags` ab und fügen dann die gewünschten über ihre `id` zur Eigenschaft `tags` der Entität hinzu.

### MCP-Server

Mit dem MCP-Server (Model Context Protocol) arbeitet ein KI-Assistent, ein Code-Editor oder ein Terminal mit Ihren Dastra-Daten. Sie richten ihn im Tab **MCP Server** der Seite **API-Schlüssel & MCP** ein, und er setzt den Tarif Dastra AI Pro voraus. Siehe [Der MCP-Server](https://doc.dastra.eu/de/features/general/ai-assistant/mcp.md).

{% hint style="warning" %}
Aufrufe, die Daten erstellen, ändern oder löschen, wirken auf Ihre echten Datensätze. Testen Sie sie zuerst in einem eigenen Mandanten.
{% endhint %}

API-Schlüssel werden auf der Seite **API-Schlüssel & MCP** verwaltet, die den Inhabern der Organisation vorbehalten ist. Siehe [API-Schlüssel verwalten](https://doc.dastra.eu/de/features/settings/api-keys.md).


---

# 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://doc.dastra.eu/de/api/configuration.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.
