ecentic API 认证。
公开发现完全无需凭证。任何读取或修改商家账户的操作,都需要您自行生成的 bearer key——无需销售电话,也无需人工开通。
自助密钥 · Bearer token · OAuth 元数据
选择请求路径
先探索 API。当客户端需要操作商家账户时,再添加 bearer key。
您的客户端
无需凭证
开放探索 + 测试环境
哪些无需密钥
发现接口是有意开放的。
/api/v1 下的所有端点都无需 Authorization 请求头即可访问,well-known 发现文档、OpenAPI 文档以及 MCP list_plans 工具也是如此。智能体在任何人创建账户之前,就可以了解 API 的完整结构——端点、套餐、协议、技能、速率限制、错误代码等。
sandbox 也同样开放:POST /api/v1/sandbox/simulation 会返回与真实模拟完全一致的响应结构,但结果基于合成评分计算,因此客户端无需任何凭证即可开发和测试。
您的客户端
需要 bearer key
REST + MCP
发送密钥
一个请求头,适用于所有场景。
在每个受保护的请求中,将密钥作为 bearer token 发送。同一个请求头适用于 REST 接口和 MCP 工具调用。
不要将密钥放入查询字符串:查询字符串可能被日志、代理和来源请求头记录,ecentic 也不会从查询字符串中读取密钥。
生成密钥
两种自助方式,均由您自行控制。
- 创建账户
- 生成密钥
- 保存一次
创建账户后,可通过控制台生成密钥,或在已认证会话中调用 create_api_key MCP 工具生成。密钥格式类似 ecentic_sk_…,长期有效,并且只显示一次——ecentic 仅存储其哈希值,因此密钥丢失后只能替换,无法恢复。
轮换方式是生成新密钥并撤销旧密钥。整个过程无需联系任何人工人员。
失败时
401 会告诉您下一步该去哪里。
- HTTP 401缺少或无效的凭证
- RFC 9728受保护资源元数据
- RFC 8414授权服务器元数据
缺少或无效凭证会返回 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 提示。