常见问题

API 地址是什么？

API 地址取决于服务部署方式。生产环境通常由反向代理提供同域访问；请向部署管理员确认服务域名。

哪些接口需要认证？

注册、登录、公开配置等公开接口通常无需认证。用户接口需 Bearer Token，项目接口还可使用项目级 API Key，内网接口需节点密钥。以 API 参考中每个接口的认证说明为准。

为什么请求返回 401？

检查令牌是否过期、格式是否为 Bearer <token>，以及该接口是否要求其他认证条件。

为什么浏览器无法在线调试？

浏览器直接调用其他域名时可能受到 CORS 策略限制。请使用配置了允许来源的部署，或通过同域反向代理请求。

如何查看准确的参数和响应？

API 参考 直接由项目 OpenAPI 规格生成，是接口定义的权威来源。