Zum Inhalt springen

ecentic: Dokumentation für Entwickler.

Alles, was ein Agent oder Entwickler benötigt, um ecentic aufzurufen: eine versionierte REST-API, ein MCP-Server, typisierte Fehler, veröffentlichte Rate-Limits und die Discovery-Dokumente, mit denen ein Crawler all das ohne menschliches Zutun finden kann.

Öffentliche Endpunkte benötigen keinen Schlüssel · OpenAPI 3.1 · RFC 9457-Fehler

01

ecentic mit einer einzigen Anfrage aufrufen

Die öffentliche Oberfläche ist ohne Authentifizierung zugänglich und CORS-offen. Starten Sie hier und erstellen Sie erst dann einen Schlüssel, wenn Sie Aktionen für ein Händlerkonto ausführen müssen.

02

Authentifizierung

Öffentliche Lesezugriffe sind offen. Alles, was ein Händlerkonto betrifft, benötigt einen Bearer-Schlüssel.

ecentic stellt langlebige API-Schlüssel aus, nachdem ein Mensch ein Konto angelegt hat. Erstellen Sie das Konto, erzeugen Sie einen Schlüssel im Dashboard oder über das authentifizierte MCP-Tool create_api_key und senden Sie ihn dann bei jedem geschützten Aufruf als Bearer-Token mit. Der Schlüssel wird nur einmal angezeigt.

Geschützte Aufrufe ohne gültigen Schlüssel liefern HTTP 401 und einen WWW-Authenticate-Header, der das Protected Resource Metadata-Dokument benennt, damit ein Agent die Discovery direkt aus dem Fehler heraus erneut ausführen kann, statt zu raten.

  • mcp — MCP-Tools gegen den ecentic MCP-Endpunkt aufrufen
  • onboarding — Shopify-, WooCommerce- und Produktfeed-Shops verbinden
POST https://ecentic.ai/api/mcp
03

Endpunkte

Die versionierte REST-Oberfläche. Pfade unter /api/v1 bleiben während der gesamten Laufzeit von v1 stabil.

04

Agentenprotokolle

ecentic unterstützt die Commerce- und Tool-Protokolle, die Agenten bereits verwenden, und veröffentlicht für jedes ein Manifest.

06

MCP-Server

Claude, ChatGPT und jeder MCP-Client können ecentic nativ aufrufen.

Der ecentic MCP-Server spricht JSON-RPC 2.0 über HTTP und ist sowohl unter /mcp als auch unter /api/mcp erreichbar. Sein Manifest wird am üblichen Well-Known-Pfad sowie als SEP-1649-Serverbeschreibung veröffentlicht.

Tools, die nur lesen (list_plans), funktionieren ohne Authentifizierung. Tools, die den Kontostatus ändern – Schlüssel erstellen, den Checkout starten oder einen Shop verbinden – benötigen einen Bearer-Schlüssel.

  • list_plans — Pläne und ihre Stripe-Verfügbarkeit
  • create_api_key — langlebigen Agentenschlüssel erstellen
  • create_checkout — Stripe-Checkout-Sitzung öffnen
  • connect_shopify, connect_woocommerce, connect_feed — Shop-Onboarding
https://ecentic.ai/.well-known/mcp.json
MCP-Server
07

Webhooks

ecentic empfängt Webhooks, versendet sie derzeit aber noch nicht.

Eingehende Endpunkte werden per Signatur verifiziert und lehnen alles ab, was die Prüfung nicht besteht, bevor ein Handler ausgeführt wird. Shopify-Compliance-Webhooks prüfen ein HMAC, Stripe prüft seinen eigenen Signatur-Header und Partner-Endpunkte prüfen ein Bearer-Secret.

Ausgehende Webhooks – also Benachrichtigungen von ecentic an Ihr System, wenn ein Scan abgeschlossen oder ein Produktangebot erneut veröffentlicht wurde – sind noch nicht veröffentlicht. Lesen Sie Scan- und Produktangebots-Ergebnisse im Dashboard aus. Die veröffentlichte REST-API stellt diese Dashboard-Ergebnisse derzeit nicht bereit; verwenden Sie die API-Referenz für die aktuell verfügbaren Operationen. MCP-Anfragen sind zustandslos; es gibt keine Subskriptionssitzung.

08

Kommandozeile

ecentic skripten, ohne einen HTTP-Client zu schreiben.

Die ecentic CLI kapselt dieselbe öffentliche Oberfläche, die hier dokumentiert ist – Discovery, Tarife, Skills, Statusprüfungen und MCP-Tool-Aufrufe –, sodass ein Agent oder Entwickler Shell-Befehle verwenden kann, statt eine Integration zu bauen.

Für authentifizierte Befehle liest sie ECENTIC_API_KEY aus der Umgebung und gibt JSON auf stdout aus, sodass sich jeder Befehl mit jq kombinieren lässt.

Codebeispiel

Jedes Dokument auf dieser Seite ist maschinenlesbar und ohne Schlüssel erreichbar.