API-Keys
Zugang: Einstellungen → API-Keys
Ein API-Key ist das Passwort, mit dem ein Programm —Ihr ERP, eine angebundene Tabelle, ein eigenes Dashboard— Ihre Epinium-Daten liest, ohne sich in der App anzumelden. Auf diesem Bildschirm werden sie erstellt, ihre Berechtigungen geändert und sie wieder aufgehoben.
Diese Seite erklärt den Bildschirm. Welche Informationen Sie mit einem Schlüssel abrufen können und wie er aus einem Programm heraus verwendet wird, steht im API-Leitfaden.
Sie wollen nur einen KI-Assistenten anbinden?
Dafür brauchen Sie keinen Schlüssel. Gehen Sie zu Einstellungen → MCP und autorisieren Sie den Assistenten im Browser.
Abfragen verbrauchen Guthaben
Jeder API-Aufruf verbraucht Guthaben Ihres Kontos — dasselbe, das die KI-Funktionen nutzen. Die Preise je Ressource stehen unter Einstellungen → Guthaben, im Abschnitt Öffentliche API und MCP-Connector.
Zwei Dinge, die Ärger ersparen: berechnet wird nur, was geliefert wird, ein fehlgeschlagener Aufruf kostet also nichts; und bei Metrik-Abfragen kostet der Zeitraum, nicht die Zahl der Zeilen. Ist das Guthaben aufgebraucht, wird der Aufruf vor der Ausführung abgewiesen und die Antwort nennt, was zu kürzen ist.
Die Einzelheiten zu den Kosten-Headern und zu diesem Fehler stehen im API-Leitfaden.
Einen Schlüssel erstellen
- Klicken Sie auf API-Key erstellen
- Geben Sie ihm einen Namen, der Sie an seinen Zweck erinnert (zum Beispiel ERP-Integration): mehr sehen Sie später nicht, um sie auseinanderzuhalten
- Haken Sie die benötigten Berechtigungen an
- Speichern Sie und kopieren Sie das angezeigte Geheimnis
- Fügen Sie es in das Werkzeug ein, das es verwenden soll
Das Geheimnis wird nur einmal angezeigt
Beim Erstellen des Schlüssels erscheint sein vollständiger Wert ein einziges Mal. Sobald Sie das Fenster schließen, lässt er sich nicht mehr wiederherstellen — weder über Epinium noch über den Support.
Die Berechtigungen
Jeder Schlüssel trägt die Berechtigungen, die Sie anhaken, und erreicht nur das, was diese öffnen. Haken Sie das Minimum an, das die Integration braucht: falls sie morgen mehr benötigt, ergänzen Sie es, ohne den Schlüssel zu wechseln.
| Berechtigung | Erlaubt das Abrufen von |
|---|---|
| Katalog (lesen) | Ihren Produkten, Marken, Ländern und Clustern |
| Kampagnen (lesen) | Kampagnen, Anzeigengruppen, Targets, Produktanzeigen und Suchbegriffen |
| Verbindungen (lesen) | Den mit Epinium verbundenen Amazon-Konten |
| Aufgaben (lesen) | Den Epinium-Aufgaben und ihren Vorschlägen |
| Skills (lesen) | Dem Katalog der Marketing-Playbooks von Epinium |
| Workflows (lesen) | Ihren Automatisierungen, deren Konfiguration und den erfassten Kampagnen |
| Workflows (schreiben) | Zusätzlich zum Abrufen: die Konfiguration Ihrer Automatisierungen ändern |
Ein Schlüssel ohne angehakte Berechtigung kann nichts abrufen.
Was Sie in der Tabelle sehen
| Spalte | Was sie Ihnen sagt |
|---|---|
| Name | Der Name, den Sie beim Erstellen vergeben haben |
| Präfix | Die ersten Zeichen des Geheimnisses. Damit erkennen Sie einen Schlüssel wieder, wenn Sie mehrere haben, ohne den Rest preiszugeben |
| Berechtigungen | Worauf dieser Schlüssel zugreift |
| Zuletzt verwendet | Wann er zuletzt benutzt wurde. Steht dort Nie verwendet, hat ihn niemand angebunden |
| Erstellt | Das Ausstellungsdatum |
Die Spalte Zuletzt verwendet ist der schnelle Weg zu vergessenen Schlüsseln: einer, der seit Monaten ungenutzt ist, ist fast immer überflüssig — und jeder aktive Schlüssel ist eine offene Tür mehr.
Berechtigungen eines Schlüssels ändern
Sie können einen bestehenden Schlüssel bearbeiten und Berechtigungen an- oder abhaken. Die Änderung greift sofort und der Schlüssel bleibt derselbe: dort, wo Sie ihn hinterlegt haben, ist nichts anzupassen.
Das ist der bessere Weg, die Reichweite einer Integration zu erweitern oder einzuschränken, weil kein neues Geheimnis erzeugt und erneut verteilt werden muss.
Einen Schlüssel widerrufen
Ein Widerruf hebt den Schlüssel endgültig auf. Jede Integration, die ihn verwendet, funktioniert sofort nicht mehr — es lohnt sich also, vorher zu wissen, wer ihn nutzt: die Spalte Zuletzt verwendet und der von Ihnen vergebene Name sind der Anhaltspunkt.
Ein widerrufener Schlüssel lässt sich nicht reaktivieren. Soll die Integration wieder laufen, erstellen Sie einen neuen und ersetzen das Geheimnis dort, wo es eingetragen war.
Wenn Sie das Geheimnis verlieren
Es lässt sich nicht wiederherstellen. Der einzige Weg ist, den Schlüssel zu widerrufen und einen neuen zu erstellen und danach das Geheimnis in dem Werkzeug zu ändern, das es verwendet hat.
Deshalb sollten Sie es gleich beim Erstellen im Passwortmanager des Teams ablegen und nicht in einer E-Mail oder einem Chat.
Wenn Sie eine Agentur sind
Dieser Bereich erscheint auch in Ihrem eigenen Agenturkonto, wie MCP und anders als Verbindungen. Und wo Sie den Schlüssel erstellen, ändert seine Reichweite:
- In Ihrem Agenturkonto erstellt, gehört der Schlüssel Ihnen und erreicht die Konten, die Ihre Kunden mit Ihnen geteilt haben. Jede Anfrage muss sagen, auf welchem sie arbeitet.
- Im Konto eines Kunden erstellt, gehört der Schlüssel diesem Kunden und erreicht nur seine Verbindungen.
Wenn Sie lediglich einen KI-Assistenten anbinden wollen, brauchen Sie keinen Schlüssel — siehe Einstellungen → MCP.