跳到主要内容

访问与 Sandbox 边界

这页只说明“对外可确认”的访问边界:哪些路由可以依照公开规范使用,以及集成前需要向平台确认哪些条件。

当前可确认的访问面

公开接口形状与鉴权设计以 API Reference 与 OpenAPI 为准;但这不等价于“任何访客都可自助获得生产权限”。

POST /api/execute 的公开 contract 标记为:

  • surface:gateway
  • auth:admin_or_api_key
  • stability:phase1_gateway

因此,execute gateway 是受授权的能力,不是匿名/自助的替代接口。本页不提供凭证申请或发放流程。

公开 channel 路由是单独的 surface。它们使用 channel key、conversation 与 workflow 标识,并在 OpenAPI 中按路由标记为 public 及对应稳定性。不要将其与 execute gateway 混用。

Sandbox 状态

当前没有公开发布的 Sandbox 环境(URL/测试账户/申请流程/隔离契约)。本地开发服务器、生产入口与公共 channel 的数据边界不同,不能直接当作 Sandbox 使用。

若未来 Sandbox 作为公开能力发布,会在 OpenAPI 与接入文档中明确基址、鉴权、数据处理边界与稳定性;在此之前,不建议以“Sandbox 已存在”为前提做方案设计。

其他未公开能力

以下内容目前没有作为公开交付面发布:

  • SDK
  • Redge
  • SLA
  • 协议专属 partner webhook

相应地,本文不提供包名、安装命令、服务地址、支持等级、响应时限或申请渠道。异步调用的当前公开方式与状态处理,见 执行生命周期

提示实施前检查
  1. 你已收到平台提供的正式基址与凭证说明(包括 scope/配额等边界)。
  2. 你没有把 public channel 的会话标识当作 gateway 凭证来用。
  3. 你没有假定 Sandbox、SDK、SLA 或 partner webhook 已公开可用。

推荐阅读

继续阅读