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

Как авторизоваться в API: Basic Auth accountId:token, где взять ключи и правила безопасности.

## Учётные данные

API использует **HTTP Basic Auth** с парой `accountId:API-токен`:

- **accountId** — идентификатор аккаунта;
- **API-токен** — ключ, созданный в **Settings → API** ([API-ключи](/article/api-keys)).

## Формат заголовка

```http
Authorization: Basic <base64(accountId:token)>
```

Пример:

```bash
# login и password = accountId и API-токен соответственно
curl -u "$ACCOUNT_ID:$API_TOKEN" \
  https://app.plaia.ru/api/integration/v1/account
```

## Проверка доступа

Запрос `GET /api/integration/v1/account` возвращает данные аккаунта — если авторизация работает, вы получите JSON с параметрами аккаунта.

## Коды ответов

| Код | Причина |
| --- | --- |
| 200/201 | Успех |
| 401 | Неверные accountId/token |
| 403 | Нет прав на действие |
| 429 | Слишком много запросов (см. [Коды ошибок и ретраи](/article/api-errors)) |

## Безопасность

1. Не встраивайте токен в клиентский код — только серверная сторона.
2. Отдельный токен на интеграцию — легко отозвать ([API-ключи](/article/api-keys)).
3. HTTPS только; plaintext-передача токена запрещена.
4. Храните в секрет-хранилище (env-переменные, vault), не в репозитории.