跳转到主要内容
GOWA 支持 HTTP Basic Auth ,没有其他:REST API 没有API的 API 密钥、无记名令牌或 JWT。 (MCP 可以另外接受 OAuth 令牌;查看 MCP 服务器.)

配置

每个逗号分隔的 user:pass 对是一个有效的登录。每个条目都必须包含一个用户名和密码。 非循环监听器拒绝在没有完整凭据的情况下开始。 绑定APP_HOST=127.0.0.1 用于未经认证的本地开发。只有当逆向代理认证呼叫者和直接访问 GOWA时,才使用 APP_ALLOW_UNAUTHENTICATED=true 。

发送凭据

凭据错误或缺失时返回 401 Unauthorized。

公共路由

WebSocket

浏览器无法在 WebSocket 连接上设置头部,所以/ws 也接受/ws?device_id=my-device&authorization=<base64 user:pass>。使用 wss:// 并编辑代理日志的凭据。 WebSocket 和 state-changing HTTP 路由拒绝不信任的浏览器来源。请在 APP_TRUSTED_ORIGINS 或 APP_CORS_ALLOWED_ORIGINS 中设置仪表板的确切来源。 通配符 CORS 源不授予此访问权限,拒绝了 file:// 中的 null 起源。 HTTP 突变来自一个不信任的源返回 403 CROSS_SITE_REQUEST_BLOCKED。请参阅浏览器访问配置。

设备头

基本身份验证标识了 API 呼叫器,而不是 WhatsApp 帐户。 当存在多个设备时,每个设备范围内的调用也需要 X-Device-Id 。请参阅 Multi-device。
基本认证每个请求都发送凭据。通常会在 GOWA 之前在信任网络之外使用HTTPS。