测试与排查

当文档里的调用结果和预期不一致时，按这个顺序排查。

排查顺序

1. 确认链路类型
2. 确认 portal
3. 确认认证模型
4. 确认必需请求头
5. 确认是否需要 Secure Channel
6. 确认 endpoint 是否真的对 API 开放

Web 链路检查表

1. 正确的 portal 入口
2. 有效 JWT
3. 有效 X-Client-Hash
4. 如果需要，X-SC-Session-Id 有效
5. 角色和 portal 权限匹配

API 链路检查表

1. 路径属于 /api/v1/**
2. 请求签名正确
3. 时间戳和 nonce 合法
4. API key 拥有需要的 scope
5. endpoint 支持 API key 访问