Informationen zu API-Schlüsseln

In diesem Artikel erfährst du, was eine API ist und wie du einen API-Schlüssel generieren kannst, um Zugriff auf deinen Mailchimp-Account zu gewähren. Wir werden auch erklären, an wen du dich bei Fragen zur Mailchimp-Marketing-API wenden kannst.

Was ist eine API?

API steht für Application Programming Interface (Anwendungsprogrammierschnittstelle). Eine API bietet sozusagen verschiedenen Apps die Möglichkeit, sich miteinander auszutauschen. Du sendest und empfängst Daten zwischen Apps mithilfe von API-Anfragen und -Antworten. Ein API-Schlüssel ist eine eindeutige Zeichenfolge, die in einer Anfrage enthalten ist, um zu überprüfen, ob das anfragende System mit dem empfangenden System kommunizieren darf.

API-Schlüssel generieren

Bei der Integration mit deinem Mailchimp-Account wirst du häufig einen API-Schlüssel generieren müssen. Benutzer mit Berechtigungen als Manager können eigene API-Schlüssel erstellen und anzeigen. Benutzer mit Admin-Berechtigungen können außerdem die von anderen Account-Benutzern generierten API-Schlüssel sehen.

So generierst du einen API-Schlüssel:

1. Klicke auf dein Profilsymbol und wähle Profil.
2. Klicke auf das Dropdown-Menü Extras und wähle dann die Option API-Schlüssel.
3. Klicke im Abschnitt „Deine API-Schlüssel“ auf Einen Schlüssel erstellen.
4. Benenne deinen Schlüssel. Gib dem Schlüssel einen aussagekräftigen Namen, damit du später weißt, welche App ihn verwendet. Denke daran, dass du nur diesen Namen und die ersten vier Ziffern auf deiner Liste der API-Schlüssel sehen wirst.
5. Klicke auf Generate Key(Schlüssel generieren).
6. Sobald wir deinen Schlüssel generiert haben, klicke auf Copy Key to Clipboard(Schlüssel in Zwischenablage kopieren). Bewahre deinen Schlüssel an einem sicheren Ort auf – du wirst ihn ab jetzt nicht mehr sehen oder kopieren können. Wenn du diesen Schlüssel verlierst, musst du einen neuen Schlüssel generieren und alle von dir verwendeten Integrationen aktualisieren.
7. Klicke auf Done (Fertig).

Einen API-Schlüssel für ungültig erklären

Wenn ein API-Schlüssel manipuliert wurde oder du die Integration, die mit ihm auf deinen Account zugegriffen hat, nicht mehr nutzt, kannst du ihn für ungültig erklären Sobald du einen API-Schlüssel für ungültig erklärt hast, kann er nicht wieder aktiviert werden. Du musst einen neuen Schlüssel generieren und alle Integrationen aktualisieren, die den ursprünglichen Schlüssel verwenden.

So erklärst du einen API-Schlüssel für ungültig:

1. Klicke auf dein Profilsymbol und wähle Profile (Profil).
2. Klicke auf das Dropdown-Menü Extras und wähle dann die Option API-Schlüssel.
3. Suche den API-Schlüssel, den du für ungültig erklären möchtest, und klicke auf Revoke(für ungültig erklären).
4. Gib im Pop-up-Dialogfenster REVOKE ein und klicke dann zur Bestätigung des Vorgangs auf Für ungültig erklären .

Sicherheit der API-Schlüssel

API-Schlüssel gewähren vollen Zugriff auf deinen Mailchimp-Account. Du solltest sie daher genauso gut schützen, wie dein Passwort. Beachte die folgenden gängigen Szenarien, wenn du API-Schlüssel verwendest.

• Weise jeder Integration einen eigenen API-Schlüssel zu. Weise jedem Schlüssel einen aussagekräftigen Namen zu, damit du weißt, welcher Schlüssel zu welcher App gehört. Wenn ein bestimmter API-Schlüssel manipuliert wurde, kannst du ihn für ungültig erklären, ohne den Zugang zu deinen anderen Integrationen zu sperren.
• Du solltest den Schlüssel niemals öffentlich zugänglich machen (etwa in einem Screenshot, einem Video oder in Hilfedokumenten). Oftmals reicht es nicht aus, die Daten einfach nur unkenntlich zu machen. Am besten entfernst du die Daten vollständig.
• Da freigegebene API-Schlüssel eines Accounts immer ein gewisses Risiko darstellen, wird die clientseitige Implementierung unserer API über CORS-Anfragen oder die Einbindung von API-Schlüsseln in mobile Apps von Mailchimp nicht unterstützt.
• Wenn du den Zugriff auf deinen Account teilen musst, generiere einen neuen Schlüssel und vergib einen Namen, damit du weißt, welchen Schlüssel du bei Bedarf für ungültig erklären musst. Sende niemals einen API-Schlüssel per E-Mail. Im Falle eines Hacker-Angriffs auf dein E-Mail-Konto könnte auch dein Mailchimp-Account gefährdet sein.
• Wenn du einem Benutzer mit Zugriff auf deinen Mailchimp-Account die Zugriffsrechte entziehst, werden wir alle API-Schlüssel, die von diesem Benutzer erstellt wurden, automatisch aus deinem Account löschen.
• Die Rolle des Benutzers, der den API-Schlüssel generiert hat, bestimmt den Zugriff auf den jeweiligen Endpunkt. Weitere Informationen zu den Berechtigungen auf Benutzerebene findest du unter Benutzerrechte in deinem Account verwalten.

API-Unterstützung

Unser Mailchimp-Support-Team ist nicht für die detaillierte API-Fehlerbehebung geschult. Wenn du Hilfe mit der Konfiguration der API benötigst, kannst du über unser Expertenverzeichnis einen Entwickler beauftragen. Hier sind externe Mailchimp-Experten aufgeführt, die du zu deiner Unterstützung beauftragen kannst.

Wenn du ein Webentwickler bist und deine eigene Integration mit Mailchimp programmieren willst, findest du in unserer API-Dokumentation einige nützliche Tipps.