# API

Über den Bereich API kannst Du nexcore mit externen Systemen verbinden oder eigene Anwendungen an die Plattform anbinden.

Hier stehen Dir zentrale Informationen und Zugänge für die Kommunikation über die REST-API von nexcore zur Verfügung.

***

## Übersicht

Im Bereich **Allgemein** findest Du folgende Informationen:

<table><thead><tr><th width="208.546875">Feld</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>API-Endpoint</strong></td><td>Die Basis-URL für alle REST-API-Aufrufe. Über diesen Endpoint können externe Systeme mit Deinem nexcore-Tenant kommunizieren.</td></tr><tr><td><strong>API-Dokumentation</strong></td><td>Verweis auf die technische Dokumentation aller verfügbaren API-Endpunkte. Sie enthält Details zu Parametern, Methoden und Response-Formaten.</td></tr><tr><td><strong>Tenant-ID</strong></td><td>Eindeutige Kennung Deines nexcore-Tenants, die bei der Authentifizierung und Datenübertragung verwendet wird.</td></tr></tbody></table>

In der darunter befindlichen **API-Key-Liste** findest Du folgende Informationen:

<table><thead><tr><th width="208.546875">Feld</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>Key-ID</strong></td><td>Individuelle ID des von Dir erstellten API-Keys (kopierbar).</td></tr><tr><td><strong>Zuletzt benutzt</strong></td><td>Zeitstempel der letzten Interaktion über den API-Key.</td></tr><tr><td><strong>Kommentar</strong></td><td>Dein individueller Kommentar (Anmerkung) zur Identifikation der Verwendung.</td></tr><tr><td><strong>Löschen</strong></td><td>Ein Button zum Löschen einzelner API-Keys.</td></tr></tbody></table>

Du kannst die API-Key-Liste bei Bedarf nach einem gewünschten Kriterium **sortieren**.

{% hint style="warning" %}
Jeder API-Key gewährt direkten Zugriff auf Daten und Funktionen innerhalb Deines Tenants. Bewahre die Keys daher stets vertraulich auf und lösche nicht mehr benötigte Schlüssel umgehend.
{% endhint %}

***

## API-Key erstellen

Mit einem Klick auf den Button **"+ API-Key erstellen"** öffnet sich ein Dialog in welchem Du einen **Kommentar** zur späteren Zuordnung der Verwendung des Keys eingeben musst.&#x20;

{% hint style="danger" %}
Der API-Key wird nur einmal angezeigt! Kopiere und notiere Dir die API Key-ID und den API Key für die weitere Verwendung (beide Elemente werden für die [Installation von nexcore.CONNECT](/documentation/integrationen/nexcore.connect/installation.md) oder die Einrichtung einer API-Verbindung benötigt)
{% endhint %}

Der nun erstellte, individuelle API-Key wird Dir sofort in der API-Key-Liste angezeigt und kann ab sofort verwendet werden.

{% hint style="info" %}
Wenn Du mehrere Integrationen nutzt (z. B. ERP-System, BI-Tool, Webservice), empfiehlt es sich, für jede Anwendung einen separaten API-Key mit individuellem Kommentar zu erstellen. So kannst Du die Nutzung besser nachvollziehen.
{% endhint %}

***

## Technische Hinweise

* Das **Rate-Limiting** (Begrenzung der API-Aufrufe pro Zeitraum) wird von Nexato verwaltet.

  Individuelle Anpassungen sind nur durch das Nexato-Team möglich.
* Alle **API-Aufrufe** werden automatisch in den **API-Logs** dokumentiert,

  die im nächsten Reiter ([Logs](/documentation/einstellungen-and-verwaltung/developer/logs.md)) eingesehen werden können.


---

# 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://docs.nexcore.de/documentation/einstellungen-and-verwaltung/developer/api.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.