Documentation ecentic pour les développeurs.
Tout ce dont un agent ou un ingénieur a besoin pour appeler ecentic : une API REST versionnée, un serveur MCP, des erreurs typées, des limites de débit publiées et des documents de découverte permettant à un crawler de tout trouver sans intervention humaine.
Les points d’accès publics ne nécessitent aucune clé · OpenAPI 3.1 · Erreurs RFC 9457
Appeler ecentic en une seule requête
La surface publique ne nécessite pas d’authentification et est ouverte au CORS. Commencez ici, puis générez une clé uniquement lorsque vous devez agir sur un compte marchand.
Authentification
Les lectures publiques sont ouvertes. Toute action touchant à un compte marchand nécessite une clé bearer.
ecentic émet des clés API longue durée après la création d’un compte par un humain. Créez le compte, générez une clé depuis le tableau de bord ou via l’outil MCP authentifié create_api_key, puis envoyez-la comme jeton bearer sur chaque appel protégé. La clé n’est affichée qu’une seule fois.
Les appels protégés sans clé valide renvoient HTTP 401 et un en-tête WWW-Authenticate nommant le document Protected Resource Metadata, afin qu’un agent puisse relancer la découverte à partir de l’échec lui-même plutôt que de deviner.
mcp— appeler des outils MCP sur le point d’accès MCP ecenticonboarding— connecter Shopify, WooCommerce et des boutiques via flux de produits
Points d’accès
La surface REST versionnée. Les chemins sous /api/v1 restent stables pendant toute la durée de v1.
Protocoles pour agents
ecentic prend en charge les protocoles de commerce et d’outils déjà utilisés par les agents, et publie un manifeste pour chacun.
Erreurs, limites et versions
Les trois contrats dont dépend une intégration, chacun documenté sur sa propre page et lisible par machine.
Erreurs typées
application/problem+json
Chaque échec est renvoyé au format application/problem+json avec un code stable lisible par machine et une indication de résolution.
Limites de débit
RateLimit / Retry-After
En-têtes RateLimit en temps réel sur chaque réponse et Retry-After sur un 429, afin qu’un agent puisse s’autoréguler.
Versionnement
Deprecation / Sunset
Version dans le chemin d’URL, avec des en-têtes Deprecation et Sunset avant toute suppression.
Serveur MCP
Claude, ChatGPT et tout client MCP peuvent appeler ecentic nativement.
Le serveur MCP ecentic utilise JSON-RPC 2.0 sur HTTP et est accessible via /mcp et /api/mcp. Son manifeste est publié sur le chemin well-known conventionnel ainsi que sous forme de fiche serveur SEP-1649.
Les outils en lecture seule (list_plans) fonctionnent sans authentification. Les outils qui modifient l’état du compte — création de clés, démarrage d’un paiement, connexion d’une boutique — nécessitent une clé bearer.
list_plans— offres et disponibilité Stripe associéecreate_api_key— générer une clé d’agent longue duréecreate_checkout— ouvrir une session de paiement Stripeconnect_shopify,connect_woocommerce,connect_feed— intégration de boutique
Webhooks
ecentic reçoit des webhooks ; il n’en envoie pas encore.
Les points d’accès entrants vérifient les signatures et rejettent tout ce qui échoue au contrôle avant l’exécution du moindre gestionnaire. Les webhooks de conformité Shopify vérifient un HMAC, Stripe vérifie son propre en-tête de signature et les points d’accès partenaires vérifient un secret bearer.
Les webhooks sortants — ecentic notifiant votre système lorsqu’un scan est terminé ou qu’une fiche produit est republiée — ne sont pas encore publiés. Consultez les résultats des scans et des fiches produit dans le tableau de bord. L’API REST publiée n’expose pas ces résultats du tableau de bord ; utilisez la référence API pour les opérations actuellement disponibles. Les requêtes MCP sont sans état ; il n’existe pas de session d’abonnement.
Ligne de commande
Automatisez ecentic sans écrire de client HTTP.
Le CLI ecentic encapsule la même surface publique que celle documentée ici — découverte, offres, compétences, état de santé et appels d’outils MCP — afin qu’un agent ou un développeur puisse utiliser le shell au lieu de créer une intégration.
Il lit ECENTIC_API_KEY depuis l’environnement pour les commandes authentifiées et affiche du JSON sur stdout, afin que chaque commande puisse être combinée avec jq.
Chaque document de cette page est lisible par machine et accessible sans clé.