跳转到内容

ecentic API 认证。

公开发现完全无需凭证。任何读取或修改商家账户的操作,都需要您自行生成的 bearer key——无需销售电话,也无需人工开通。

自助密钥 · Bearer token · OAuth 元数据

01

选择请求路径

先探索 API。当客户端需要操作商家账户时,再添加 bearer key。

您的客户端

无需凭证

开放探索 + 测试环境

哪些无需密钥

发现接口是有意开放的。

无需凭证

02

生成密钥

两种自助方式,均由您自行控制。

  1. 创建账户
  2. 生成密钥
  3. 保存一次

创建账户后,可通过控制台生成密钥,或在已认证会话中调用 create_api_key MCP 工具生成。密钥格式类似 ecentic_sk_…,长期有效,并且只显示一次——ecentic 仅存储其哈希值,因此密钥丢失后只能替换,无法恢复。

轮换方式是生成新密钥并撤销旧密钥。整个过程无需联系任何人工人员。

完整注册指南
03

失败时

401 会告诉您下一步该去哪里。

  1. HTTP 401缺少或无效的凭证
  2. RFC 9728受保护资源元数据
  3. RFC 8414授权服务器元数据
401

缺少或无效凭证会返回 HTTP 401,并附带 WWW-Authenticate 响应头,指向 Protected Resource Metadata 文档(RFC 9728)。继续跟随即可访问授权服务器元数据(RFC 8414),因此客户端即使遇到 401,也无需人工阅读文档即可发现认证方式。

在 REST 接口中,响应体是 RFC 9457 problem,包含 code: "unauthenticated"。在 MCP 端点中,则会返回代码为 -32001 的 JSON-RPC 错误,并在 error.data 中附带 resource_metadata 提示。

评估 ecentic 永远不需要凭证——只有操作商家账户时才需要。