> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentifizierung

> Erfahre, wie du dich mit API-Schlüsseln bei der Macaly-API authentifizierst

<Callout icon="user">
  Nur im [**Agentur-Plan**](/docs/de/welcome/pricing) verfügbar
</Callout>

Die Macaly-API verwendet API-Schlüssel zur Authentifizierung. API-Schlüssel sind team-gebunden und teilen sich das gleiche Credit-System wie die Weboberfläche.

## Einen API-Schlüssel erhalten

1. Melde dich bei deinem Macaly-Konto an
2. Klicke auf dein Profil (oben rechts)
3. Gehe zu **Einstellungen → API-Schlüssel**
4. Klicke auf "Neuen API-Schlüssel erstellen"
5. Kopiere den Schlüssel sofort (er wird nur einmal angezeigt)

## Den API-Schlüssel verwenden

Füge den API-Schlüssel im `Authorization`-Header für alle Anfragen ein:

```
Authorization: Bearer macaly_your_api_key_here
```

### Beispielanfrage

```bash theme={null}
curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'
```

## Format des API-Schlüssels

| Eigenschaft | Wert |
| - | - |
| Präfix | `macaly_` |
| Gesamtlänge | 39 Zeichen |
| Beispiel | `macaly_abc123def456ghi789jkl012mno345` |

## Bewährte Sicherheitspraktiken

<Warning>
  API-Schlüssel gewähren vollen Zugriff auf die Ressourcen und Credits deines Teams. Behandle sie wie Passwörter.
</Warning>

1. **Bewahre Schlüssel sicher auf** - Verwende Umgebungsvariablen, committe sie nie in den Code
2. **Erneuere Schlüssel regelmäßig** - Widerrufe und erstelle Schlüssel regelmäßig neu
3. **Verwende separate Schlüssel** - Erstelle unterschiedliche Schlüssel für unterschiedliche Umgebungen/Anwendungen
4. **Überwache die Nutzung** - Prüfe dein Guthaben regelmäßig über das Dashboard
5. **Widerrufe kompromittierte Schlüssel** - Wenn ein Schlüssel offengelegt wurde, widerrufe ihn sofort

## Anfragelimits

* Fehlgeschlagene Versuche mit dem API-Schlüssel sind auf 5 pro Minute pro IP-Adresse begrenzt
* Das schützt vor Brute-Force-Angriffen

## Schlüsselverwaltung

Du kannst deine API-Schlüssel im Macaly-Dashboard verwalten:

* **Schlüssel anzeigen** - Sieh alle aktiven Schlüssel mit Erstellungsdatum und letzter Nutzung
* **Schlüssel erstellen** - Generiere neue Schlüssel mit optionalen Namen zur Identifizierung
* **Schlüssel widerrufen** - Deaktiviere Schlüssel, die nicht mehr benötigt werden oder kompromittiert wurden


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.