接入指南
本地调试
使用真实应用 Key 验证 JSON 与 SSE。
启动示例
在项目根目录执行 pnpm demo:gateway。本地服务监听 4100 端口，通过 HTTP 请求平台验证应用 Key，业务响应来自后台配置的上游服务。
调试步骤
- 在 应用管理 创建或选择一个已启用的应用。
- 在本地 Demo 下拉选择已创建的应用。
- 选择已绑定能力，调用普通 JSON，检查 HTTP 状态和响应。
- 调用 SSE，确认内容逐段返回；点击断开可取消请求。
- 切换未绑定能力应返回 403，应用不存在或密钥不可恢复时拒绝调用。
真实业务联调
使用前在运营后台配置对应上游和密钥，并根据能力文档准备请求体。Demo 会实际调用上游；未配置地址或密钥返回 503。
排障
检查 model、应用状态、能力绑定和业务路径。参见 错误码。提交问题时仅提供脱敏信息，不发送 Key 或完整用户数据。
Demo 浏览器通过同源 /api/invoke/{path}?model={id} 提交业务数据，不携带应用凭证。Demo 服务端根据应用 ID 从数据库读取并解密凭证，再交给网关鉴权；不在 HTML、响应或前端存储中下发该值。仅供本机使用，正式部署需接入业务用户鉴权。
Demo 调用需要先启动 pnpm dev:server-api。Demo 服务端只负责读取应用凭证并通过 HTTP 请求平台，权限校验、上游转发、统计及失败采集统一由 server-api 完成。平台地址默认 http://127.0.0.1:4000，可用 DEMO_PLATFORM_URL 调整。