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
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.
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 aufrufenonboarding— Shopify-, WooCommerce- und Produktfeed-Shops verbinden
Endpunkte
Die versionierte REST-Oberfläche. Pfade unter /api/v1 bleiben während der gesamten Laufzeit von v1 stabil.
Agentenprotokolle
ecentic unterstützt die Commerce- und Tool-Protokolle, die Agenten bereits verwenden, und veröffentlicht für jedes ein Manifest.
Fehler, Limits und Versionen
Die drei Schnittstellenvereinbarungen, auf denen eine Integration beruht – jeweils auf einer eigenen Seite dokumentiert und maschinenlesbar.
Typisierte Fehler
application/problem+json
Jeder Fehler wird als application/problem+json mit stabilem maschinenlesbarem Code und einem Hinweis zur Behebung zurückgegeben.
Rate-Limits
RateLimit / Retry-After
Live-RateLimit-Header bei jeder Antwort und Retry-After bei einem 429, damit ein Agent sich selbst drosseln kann.
Versionierung
Deprecation / Sunset
Version im URL-Pfad, mit Deprecation- und Sunset-Headern, bevor etwas entfernt wird.
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ügbarkeitcreate_api_key— langlebigen Agentenschlüssel erstellencreate_checkout— Stripe-Checkout-Sitzung öffnenconnect_shopify,connect_woocommerce,connect_feed— Shop-Onboarding
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.
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.
Jedes Dokument auf dieser Seite ist maschinenlesbar und ohne Schlüssel erreichbar.