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

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

  • accountId — идентификатор аккаунта;
  • API-токен — ключ, созданный в Settings → API (API-ключи).

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

Authorization: Basic <base64(accountId:token)>

Пример:

# 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 Слишком много запросов (см. Коды ошибок и ретраи)

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

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