环境与入口
SlaunchX 会按链路和 portal 入口区分请求上下文。
请求路径
| 链路 | 前缀 | 典型调用方 |
|---|---|---|
WEB | /web/v1/** | 浏览器应用、portal 前端、已登录操作流 |
API | /api/v1/** | 使用 API key 的后台系统 |
入口规则
WEB 请求应当从带 portal 上下文的入口进入。在部署环境中，Nginx 会按子域名自动注入 X-PORTAL-ACCESS-CODE。如果你绕开正常入口直接请求，可能直接得到 403。
常见误区
最常见的错误是把 /web/v1/** 当成通用后端 API 来调。实际它通常依赖：
- portal access code 上下文
- JWT 会话
X-Client-Hash- Secure Channel 会话
先读 Web 链路与 API 链路 和 认证模型 再用 curl 或 Postman 直连。