访问与 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
相应地,本文不提供包名、安装命令、服务地址、支持等级、响应时限或申请渠道。异步调用的当前公开方式与状态处理,见 执行生命周期。
提示实施前检查
- 你已收到平台提供的正式基址与凭证说明(包括 scope/配额等边界)。
- 你没有把 public channel 的会话标识当作 gateway 凭证来用。
- 你没有假定 Sandbox、SDK、SLA 或 partner webhook 已公开可用。
推荐阅读