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
- Stellen Sie die Zugriffsstufe jedes Bereichs ein: der Schlüssel startet mit Nur lesen, was fast jede Integration braucht. Muss Ihre etwas ändern, heben Sie diesen Bereich auf Bearbeiten 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 erreicht nur die Bereiche, die Sie ihm öffnen, und zwar auf der Stufe, die Sie ihnen geben. Geben Sie ihm das Minimum, das die Integration braucht: falls sie morgen mehr benötigt, heben Sie es an, ohne den Schlüssel zu wechseln.
| Bereich | Was er öffnet |
|---|---|
| Katalog | Ihren Produkten, Marken, Ländern, Keyword-Gruppierungen und Prompts samt Kennzahlen. Mit Bearbeiten auch Keyword-Gruppierungen anlegen, ihre Keywords, Produkte und Prompts ändern und sie löschen sowie Ihre Prompts anlegen und bearbeiten |
| Kampagnen | Kampagnen, Portfolios, Anzeigengruppen, Ausrichtungen, Produktanzeigen und Suchbegriffen samt Kennzahlen. Mit Bearbeiten auch Kampagnen und Portfolios anlegen und Gebote, Budgets und Status bei Amazon ändern |
| Verbindungen | Den mit Epinium verbundenen Amazon-Konten und Shopify- und WooCommerce-Shops: was du verbunden hast, nicht was darin steht |
| Daten deiner verbundenen Shops und Plattformen | Dem, was in deinen Shopify- und WooCommerce-Shops steckt: Produkte, Bestand, Preise und alles Weitere, was sie bereitstellen, und dem Protokoll der dort vorgenommenen Änderungen. Darüber fragt ein KI-Assistent den Shop ab. Mit Bearbeiten auch Produkte und Inhalte direkt im Shop anlegen, bearbeiten und löschen, ohne vorherige Prüfung |
| Aufgaben | Den Epinium-Aufgaben und ihren Vorschlägen. Mit Bearbeiten auch Aufgaben anlegen, ihre Vorschläge annehmen oder ablehnen und das Angenommene anwenden |
| CMO Brain | Dem Katalog der Marketing-Playbooks von Epinium |
| Arbeitsabläufe | Ihren Automatisierungen, deren Konfiguration und der Performance der Kampagnen, die sie optimieren |
Jeder Bereich wird auf eine von drei Stufen gesetzt: Kein Zugriff, Ansehen oder Bearbeiten. Heute erlauben Katalog, Kampagnen, Daten deiner verbundenen Shops und Plattformen, Aufgaben und Arbeitsabläufe Bearbeiten, und Bearbeiten schließt Ansehen ein: eine Integration, die schreibt, liest auch.
Bearbeiten gibt es in den Plänen Business und Master. In Free und Guru lesen Schlüssel nur, und die Stufe Bearbeiten erscheint gesperrt. Wechseln Sie in einen dieser Pläne, funktioniert ein Schlüssel, der schon Bearbeiten hatte, weiter zum Lesen, aber seine Schreibzugriffe werden abgelehnt.
Darüber verschieben zwei Vorlagen alle Bereiche auf einmal: Vollzugriff und Nur lesen. Ein Schlüssel braucht mindestens eine Berechtigung: ohne jede würde er bei allen seinen Aufrufen scheitern und lässt sich so nicht speichern.
Was Sie in der Tabelle sehen
| Spalte | Was sie Ihnen sagt |
|---|---|
| Name | Der Name, den Sie beim Erstellen vergeben haben, mit dem Präfix darunter: die ersten Zeichen des Geheimnisses, um ihn ohne Preisgabe des Rests zu erkennen |
| Zugriff | Eine Zusammenfassung als Etikett: Vollzugriff, Nur lesen, Personalisiert (eine selbst gewählte Kombination) oder Kein Zugriff in Rot, was bedeutet, dass dieser Schlüssel nicht funktioniert |
| 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 die Stufe jedes Bereichs anheben oder senken. 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.