域名与路由说明
为什么要区分几个地址
Codebyby 当前方案会把公开页面拆分为几个不同职责的入口，避免把文档、主站和运行中的 API 中继混在同一个公开路由里。
- 主站域名：承载登录、控制台与产品入口
- 文档域名：承载接入说明、FAQ、隐私政策、服务条款与联系页
- API 中继地址：承载真实请求流量，由具体实例或运营方提供
你应该从哪里拿地址
请始终以当前部署实例公布的地址为准，优先来源通常是：
- 控制台中显示的接入信息
- 运营方提供的接入文档
- 当前文档站中的公开说明
不要默认使用上游供应商官网地址，也不要把文档域名误当成 API 请求地址。
常见分工
一个典型部署通常会长成这样：
- 主站：用于账号登录、查看套餐、管理 Key
- 文档站：用于查看接入指南和公开法律页面
- API 中继：用于程序真正发起请求
它们可以在同一个品牌下，但路径和域名职责通常不同。
路由变更时怎么处理
如果运营方调整了域名、路径前缀或网关策略，建议按下面顺序处理：
- 先更新环境变量或客户端配置中的基础地址。
- 用最小请求验证新地址是否可用。
- 再切换正式流量。
- 保留旧配置一小段观察期，确认没有残留调用。
新手最容易犯的错误
- 把文档域名当成 API 地址
- 复制了上游默认示例，但没有替换成中继地址
- 只改了 Host，没有同步检查路径前缀
- 域名已经轮换，但本地环境变量还在用旧值