# Базовая авторизация (Basic Auth)

В данной статье будут рассмотрена базовая авторизация (Basic Auth), которая используется для доступа ко многим API сервиса **Webim**.

С помощью данного метода авторизации в заголовке запроса передаётся пара `имя_пользователя:пароль` (например, `username:password`). Кодирование данных осуществляется при помощи стандарта `Base64`, который преобразует данные пользователя в 64-символьную строку.

В **Webim** базовая авторизация используется в следующих механизмах:

  * [Webim Stored Data API](https://webim.ru/kb/dev/api/stored-data/overview.html)

  * [Обработчики событий чата](https://webim.ru/kb/dev/chat-handlers/overview.html)

  * [Мониторинг работы сервиса Webim](https://webim.ru/kb/devops/monitoring/monitoring-endpoints.html)

Доступ к API разрешен для клиентов с корпоративным тарифом.

## Базовый URL

В запросах, предусматривающих базовую авторизацию, используется базовый URL-адрес клиента.

Базовый URL — это домен вашего аккаунта. Он зависит от вашей сетевой конфигурации:

  * Для hosted-клиентов базовый URL — это доменное имя (FQDN), назначенное хосту (серверу), на котором развернут Webim Server. Обычно это тот же адрес, по которому открывается интерфейс Webim, например:

    https://chat.mycompany.com/

  * Для облачных клиентов базовый URL имеет вид:

    https://{account_name}.webim.ru/

    Где account_name — имя вашего аккаунта Webim.

На базовый URL отправляются запросы для доступа к **Webim API**.

Пример готового запроса к **Webim Stored Data API**:

```
https://webim.webim.ru/api/v4/operators
```

Данный запрос должен вернуть список всех операторов.

## Авторизация

Для авторизации используется Email и пароль пользователя **Webim** с ролью администратора.

Осуществляется basic авторизация следующим образом:

```
curl -u {admin_email}:{admin_password} {base_url}/api/{request}
```

Где `admin_email` — Email администратора, `admin_password` — пароль администратора, `base_url` — базовый URL для вашей сетевой конфигурации, `request` — Ваш запрос к API.

Пример curl-запроса:

```
curl -u ivanov@webim.ru:password12345 https://companyname.webim.ru/api/v2/operators
```

Таким образом, после `curl -u` идёт Email пользователя, двоеточие, его пароль, а затем URL запроса.

Работа API осуществляется только по протоколу HTTPS.

Все данные возвращаются в кодировке `UTF-8`.

Формат времени `ISO 8601` и `UTC` в качестве часового пояса (временной зоны).

Формат временных интервалов: секунды.

---

Источник: https://webim.ru/kb/dev/api/basic-auth.html