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
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.
Jeder Endpoint unter /api/v1 antwortet ohne Authorization-Header, ebenso die Well-Known-Discovery-Dokumente, das OpenAPI-Dokument und das MCP-Tool list_plans. Ein Agent kann die gesamte Struktur der API kennenlernen — Endpoints, Pläne, Protokolle, Fähigkeiten, Rate Limits und Fehlercodes — bevor überhaupt ein Konto erstellt wurde.
Auch die Sandbox ist offen: POST /api/v1/sandbox/simulation liefert exakt dieselbe Antwortstruktur wie eine echte Simulation, berechnet aus synthetischem Scoring, sodass sich ein Client vollständig ohne Zugangsdaten entwickeln und testen lässt.
Ihr Client
Bearer-Schlüssel erforderlich
REST + MCP
Einen Schlüssel verwenden
Ein Header, überall.
Senden Sie den Schlüssel als Bearer-Token bei jeder geschützten Anfrage. Derselbe Header funktioniert sowohl für die REST-Oberfläche als auch für MCP-Tool-Aufrufe.
Legen Sie den Schlüssel nicht in einem Query-String ab: Query-Strings landen in Logs, Proxys und Referrer-Headern, und ecentic liest ihn dort nicht aus.
Einen Schlüssel erstellen
Zwei Self-Service-Wege, beide unter Ihrer Kontrolle.
- Konto erstellen
- Schlüssel generieren
- 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.
Wenn es fehlschlägt
Ein 401 zeigt Ihnen, wie es weitergeht.
- HTTP 401Fehlende oder ungültige Anmeldedaten
- RFC 9728Metadaten geschützter Ressourcen
- RFC 8414Metadaten des Autorisierungsservers
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.