接入指南
上线与运维
部署、排障、服务边界和发布检查。
部署要求
门户、文档、控制台和后端分别运行。对外入口使用 HTTPS；文档统一挂载 /docs，能力接口使用 /openapi/v1/。SSE 的反向代理需要关闭响应缓冲。
上游地址和凭证由后端配置管理，调用方只能选择已登记的 model，不能指定任意转发目标。未配置上游时返回 503。
上线准备
核对应用启用状态、已关联能力、业务输入输出与上游连通性。测试成功、无权限、超时和 SSE 取消；确保客户端正确处理 错误码，且不会把非幂等请求自动重试。
调用排障
当前未提供统一调用日志查询功能。接入方应记录发生时间、HTTP 状态、能力标识及自己的请求编号，避免记录完整凭证和敏感请求体。长连接断开后不能假设业务操作未执行。
额度与服务等级
当前网关尚未实现统一计费、额度审批或 SLA 配置。门户中的相关服务信息不能作为已开通额度或服务等级的承诺；具体服务范围以双方实际确认的接入约定为准。
灰度与回滚
建议先用独立测试应用完成验证，再逐步增加业务流量。平台目前没有控制台灰度开关；发布与回滚由部署流程执行。权限变更在下一次请求生效，已开始的 SSE 流保持原连接。