> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Аутентификация API

> GOWA аутентифицирует вызовы API только с HTTP Basic Auth.

GOWA поддерживает **HTTP Basic Auth** и ничего другого: нет ни ключей API, ни токенов предъявителя или JWT для REST API. (MCP может дополнительно принимать токены OAuth; см. [MCP сервер](https://gowa-docs.mintlify.site/ru/integrations/mcp.md#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D1%8B-%D1%81-oauth).)

## Настроить

```bash theme={null}
APP_BASIC_AUTH=admin:changeme,ops:another-password   # or --basic-auth=admin:changeme
```

Каждая пара `user:pass` через запятую является допустимой логином. Каждая запись должна содержать как имя пользователя, так и пароль. Слушатель нециклического повтора отказывается запускать без полных учетных данных. Привязывайте `APP_HOST=127.0.0.1` для локальной разработки, не прошедшей проверку подлинности. Используйте `APP_ALLOW_UNAUTHENTICATED=true` только в том случае, если лимит авторизации звонящих и прямой доступ к GOWA ограничен.

## Отправить учетные данные

```bash curl theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```bash Header theme={null}
curl -H "Authorization: Basic $(echo -n 'admin:changeme' | base64)" \
  -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```javascript JavaScript theme={null}
const res = await fetch("http://localhost:3000/user/my/groups", {
  headers: {
    Authorization: "Basic " + Buffer.from("admin:changeme").toString("base64"),
    "X-Device-Id": "my-device",
  },
});
```

```python Python theme={null}
import requests
r = requests.get("http://localhost:3000/user/my/groups",
                 auth=("admin", "changeme"),
                 headers={"X-Device-Id": "my-device"})
```

Неправильные или отсутствующие учетные данные возвращают `401 Unauthorized`.

## Общественные маршруты

| Маршрут | Почему |
| - | - |
| `/health` | Проверка свинца. |
| `/statics/*` | QR-изображения и медиа-файлы. Известные URL-адреса остаются общедоступными. Не-изображения загружают файлы в виде вложений. Защитите доступ по вашему прокси при необходимости. |
| `/chatwoot/webhook`, `/chatwoot/webhook/{device_id}` | Called by Chatwoot; secured by `CHATWOOT_WEBHOOK_SECRET`. |
| Конечные точки MCP и метаданные `/.well-known/*` | OAuth поток, когда включено. |

## Веб-сокет

Браузеры не могут устанавливать заголовки при подключении к WebSockt, поэтому `/ws` также принимает `/ws?device_id=my-device&authorization=<base64 user:pass>`. Используйте `wss://` и redact учетные данные из логов прокси.

WebSocket и изменяющиеся состояния HTTP-маршруты отвергают ненадежные источники происхождения браузера. Установите точное происхождение панели инструментов в `APP_TRUSTED_ORIGINS` или `APP_CORS_ALLOWED_ORIGINS`. Появление wildcard CORS не предоставляет этот доступ, а `null` происходит от страниц `file://`. HTTP мутации от ненадежных источников, возвращающие `403 CROSS_SITE_REQUEST_BLOCKED`. Смотрите [конфигурацию доступа браузера](https://gowa-docs.mintlify.site/ru/authentication.md#cors).

## Заголовок устройства

Basic Auth идентифицирует вызывающего API, а не аккаунт WhatsApp. Если существует более одного устройства, каждый вызов, относящийся к конкретному устройству, также требует `X-Device-Id`. См. [Работа с несколькими устройствами](https://gowa-docs.mintlify.site/ru/concepts/multidevice.md).

> [!WARNING]
>
> Базовая аутентификация отправляет учетные данные по каждому запросу. Всегда используйте HTTPS перед GOWA вне доверенной сети.


## Related topics

- [Проверка подлинности](https://gowa-docs.mintlify.site/ru/authentication.md)
- [Справочник по API](https://gowa-docs.mintlify.site/ru/api-reference/introduction.md)
- [События WebSocket](https://gowa-docs.mintlify.site/ru/api-reference/websocket.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/ru/index.md)
- [Интеграция с Chatwoot](https://gowa-docs.mintlify.site/ru/integrations/chatwoot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.