# API-Zugang

> Was die nebty API abdeckt, wie Sie einen API-Key bekommen und was der Key darf.

Mit der nebty API bekommen Ihre eigenen Tools dieselben Daten, die Sie im Dashboard sehen. Sie können Ihre Brands, deren überwachte Domains und Scans sowie Ihre Takedowns lesen. Außerdem können Sie einen neuen Takedown anfordern.

- **Basis-URL:** `https://app.nebty.de/core/api/`
- **Format:** JSON hin, JSON zurück
- **Referenz:** Alle Endpunkte stehen in der [API-Referenz](https://docs.nebty-id.com/api/reference/) (auf Englisch).
- **OpenAPI-Dokument:** Laden Sie [`openapi.json`](https://docs.nebty-id.com/api/openapi.json) herunter, um einen Client zu erzeugen oder die API in ein Tool wie Postman zu importieren.

Die API ist für Ihre eigenen Skripte und Integrationen. Wenn Sie stattdessen einem KI-Assistenten wie Claude in normaler Sprache Fragen zu Ihren nebty-Daten stellen möchten, brauchen Sie keinen API-Key: siehe [nebty mit Claude verbinden](https://docs.nebty-id.com/de/mcp/connect/).

## API-Key bekommen

Ihren Key erstellen Sie selbst im Dashboard. Das können Brand-Admins sowie Partner- und Enterprise-Konten; Ihre E-Mail-Adresse muss bestätigt sein. Wenn Sie keinen Key erstellen können, fragen Sie einen Admin Ihrer Brand oder schreiben Sie an <benedikt@nebty-id.com>.

1. Öffnen Sie im Dashboard die **Einstellungen** und dort die Karte **API-Schlüssel** (1). Wählen Sie **API-Schlüssel erstellen** (2).

   ![Einstellungen mit der Karte API-Schlüssel, markiert mit 1, und der Schaltfläche API-Schlüssel erstellen, markiert mit 2](https://docs.nebty-id.com/images/docs/guides/de/api-access/1-api-key-card.webp)

2. Kopieren Sie den neuen Key (1) sofort. Der vollständige Key wird nur einmal angezeigt (2). Speichern Sie ihn in einem Passwort-Manager oder einem Secret Store, nicht im Quellcode.

   ![Karte API-Schlüssel mit dem neuen Key (1), dem Hinweis, dass er nur einmal angezeigt wird (2), und den Schaltflächen Schlüssel ersetzen (3) und Schlüssel widerrufen (4)](https://docs.nebty-id.com/images/docs/guides/de/api-access/2-new-key.webp)

Jeder Benutzer hat einen Key. Auf derselben Karte sehen Sie, wann er erstellt und zuletzt verwendet wurde. **Schlüssel ersetzen** (3) erstellt einen neuen Key, und der alte funktioniert sofort nicht mehr. **Schlüssel widerrufen** (4) schaltet den Key sofort ab. Tools, die noch den alten Key nutzen, schlagen fehl, bis Sie dort den neuen eintragen.

## Was der Key darf

Ein Key gehört zu genau einem nebty-Benutzer und handelt als dieser Benutzer:

- Er sieht dieselben Brands und Takedowns wie dieser Benutzer im Dashboard. Ändern sich die Rechte des Benutzers, ändern sich auch die Rechte des Keys.
- Er darf **nicht nur** lesen. Er kann über die API alles, was dieser Benutzer kann.
- Ein Takedown, den Sie für eine Brand mit aktivem Monitoring anfordern, startet sofort mit dem Status `OPEN`. Es gibt keinen zusätzlichen Bestätigungsschritt.

Behandeln Sie den Key wie ein Passwort. Wenn Sie glauben, dass er bekannt geworden ist, ersetzen oder widerrufen Sie ihn sofort in den **Einstellungen**.

## Key mitsenden

Senden Sie den Key im Header `Authorization` mit dem Schema `Api-Key`:

```http
Authorization: Api-Key nbty_your_key
```

Verwenden Sie `Api-Key`, nicht `Bearer`. Eine Anfrage mit fehlendem, falschem oder inaktivem Key bekommt `401 Unauthorized`.

## Nächste Schritte

- [Schnellstart](https://docs.nebty-id.com/de/api/quickstart/): die ersten Aufrufe mit curl.
- [Grundlagen](https://docs.nebty-id.com/de/api/basics/): Seitenaufteilung, kompakte Antworten und Fehler.
- [nebty mit Claude verbinden](https://docs.nebty-id.com/de/mcp/connect/): nebty aus einem KI-Assistenten nutzen, ohne API-Key.