Zum Inhalt springen

ecentic API: Authentifizierung.

Für die öffentliche Discovery sind keinerlei Zugangsdaten erforderlich. Alles, was ein Händlerkonto liest oder verändert, benötigt einen Bearer-Schlüssel, den Sie selbst erstellen — kein Vertriebsgespräch, keine manuelle Bereitstellung.

Self-Service-Schlüssel · Bearer-Tokens · OAuth-Metadaten

01

Einen Anfragepfad auswählen

Entdecken Sie zuerst die API. Fügen Sie einen Bearer-Schlüssel hinzu, wenn Ihr Client im Namen eines Händlerkontos handelt.

Ihr Client

Keine Zugangsdaten erforderlich

Discovery + Sandbox

Was keinen Schlüssel benötigt

Discovery ist bewusst offen.

Keine Zugangsdaten erforderlich

02

Einen Schlüssel erstellen

Zwei Self-Service-Wege, beide unter Ihrer Kontrolle.

  1. Konto erstellen
  2. Schlüssel generieren
  3. Einmal speichern

Erstellen Sie ein Konto und erzeugen Sie anschließend einen Schlüssel entweder im Dashboard oder durch Aufruf des MCP-Tools create_api_key aus einer authentifizierten Sitzung. Schlüssel sehen aus wie ecentic_sk_…, sind langlebig und werden genau einmal angezeigt — ecentic speichert nur einen Hash, daher wird ein verlorener Schlüssel ersetzt statt wiederhergestellt.

Für eine Rotation erstellen Sie einen neuen Schlüssel und widerrufen den alten. Kein Teil dieses Prozesses erfordert den Kontakt mit einer Person.

Vollständige Registrierungsanleitung
03

Wenn es fehlschlägt

Ein 401 zeigt Ihnen, wie es weitergeht.

  1. HTTP 401Fehlende oder ungültige Anmeldedaten
  2. RFC 9728Metadaten geschützter Ressourcen
  3. RFC 8414Metadaten des Autorisierungsservers
401

Fehlende oder ungültige Zugangsdaten führen zu HTTP 401 mit einem WWW-Authenticate-Header, der auf das Protected Resource Metadata-Dokument (RFC 9728) verweist. Von dort gelangt ein Client zu den Metadaten des Authorization-Servers (RFC 8414), sodass ein Client nach einem 401 selbstständig erkennen kann, wie die Authentifizierung funktioniert, ohne dass jemand die Dokumentation lesen muss.

Auf der REST-Oberfläche ist der Body ein RFC 9457-Problem mit code: "unauthenticated". Auf dem MCP-Endpoint ist es ein JSON-RPC-Fehler mit dem Code -32001 und einem resource_metadata-Hinweis in error.data.

Zugangsdaten sind nie erforderlich, um ecentic zu bewerten — nur für Aktionen auf einem Händlerkonto.