跳转到内容

ecentic 开发者 文档。

智能体或工程师调用 ecentic 所需的一切:版本化 REST API、MCP 服务器、类型化错误、公开的速率限制,以及让爬虫无需人工介入即可发现全部内容的发现文档。

公开端点无需密钥 · OpenAPI 3.1 · RFC 9457 错误

01

一次请求调用 ecentic

公开接口无需认证并开放 CORS。先从这里开始,只有在需要操作商家账户时才创建密钥。

02

认证

公开读取接口开放访问。任何涉及商家账户的操作都需要 Bearer key。

ecentic 会在人工创建账户后签发长期有效的 API key。创建账户后,可在控制台或通过已认证的 MCP 工具 create_api_key 创建密钥,然后在每个受保护请求中将其作为 bearer token 发送。密钥仅显示一次。

没有有效密钥的受保护请求会返回 HTTP 401,并附带 WWW-Authenticate header,指向 Protected Resource Metadata 文档,使智能体能够根据失败结果重新执行发现流程,而无需猜测。

  • mcp — 调用 ecentic MCP 端点上的 MCP 工具
  • onboarding — 连接 Shopify、WooCommerce 和商品 feed 店铺
POST https://ecentic.ai/api/mcp
03

端点

版本化 REST 接口。/api/v1 下的路径在 v1 生命周期内保持稳定。

04

智能体协议

ecentic 支持智能体已在使用的电商与工具协议,并为每种协议发布对应清单。

06

MCP 服务器

Claude、ChatGPT 及任何 MCP 客户端都可原生调用 ecentic。

ecentic MCP 服务器通过 HTTP 使用 JSON-RPC 2.0,可通过 /mcp 和 /api/mcp 访问。其清单发布在约定的 well-known 路径,同时也以 SEP-1649 服务器卡片形式发布。

只读取数据的工具(list_plans)无需身份验证。会更改账户状态的工具——创建密钥、发起结账、连接店铺——需要 Bearer 密钥。

  • list_plans — 套餐及其 Stripe 可用性
  • create_api_key — 签发长期有效的智能体密钥
  • create_checkout — 创建 Stripe 结账会话
  • connect_shopify、connect_woocommerce、connect_feed — 店铺接入
https://ecentic.ai/.well-known/mcp.json
MCP 服务器
07

Webhook

ecentic 接收 webhooks;目前尚不支持向外发送。

入站端点会先验证签名,未通过校验的请求会在任何处理程序运行前被拒绝。Shopify 合规 webhook 会验证 HMAC,Stripe 会验证自己的签名头,合作方端点则会验证 bearer secret。

出站 webhook(例如 ecentic 在扫描完成或商品信息重新发布时通知您的系统)尚未发布。请在控制台查看扫描和商品信息结果。当前公开的 REST API 不提供这些控制台结果;请参考 API 文档了解目前可用的操作。MCP 请求是无状态的,不存在订阅会话。

08

命令行

无需编写 HTTP 客户端即可为 ecentic 编写脚本。

ecentic CLI 封装了这里文档中相同的公开能力——发现、套餐、技能、健康状态以及 MCP 工具调用——因此智能体或开发者可以直接通过 shell 调用,而无需构建集成。

CLI 会从环境变量读取 ECENTIC_API_KEY 用于需要认证的命令,并将 JSON 输出到 stdout,因此每个命令都可以与 jq 配合使用。

代码示例

本页所有文档都支持机器读取,并且无需密钥即可访问。