Skip to main content
Nur im Agentur-Plan verfügbar
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:

Beispielanfrage

Format des API-Schlüssels

Bewährte Sicherheitspraktiken

API-Schlüssel gewähren vollen Zugriff auf die Ressourcen und Credits deines Teams. Behandle sie wie Passwörter.
  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