Учётные данные
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 | Слишком много запросов (см. Коды ошибок и ретраи) |
Безопасность
- Не встраивайте токен в клиентский код — только серверная сторона.
- Отдельный токен на интеграцию — легко отозвать (API-ключи).
- HTTPS только; plaintext-передача токена запрещена.
- Храните в секрет-хранилище (env-переменные, vault), не в репозитории.