Relavio Docs

Appearance

Лимиты и тарификация API ​

Relavio ограничивает использование API в зависимости от активного тарифа, баланса и типа операции. Лимиты помогают контролировать нагрузку и расходы аккаунта.

Какие запросы тарифицируются ​

Платная проверка применяется к Search API:

http
POST /api/v1/search

Этот endpoint используется быстрым поиском, каталогом и каталогом с фильтрами.

Suggest API и Events API требуют API-ключ, но не проходят через middleware платного API-использования.

Бесплатный лимит ​

Если у пользователя нет положительного баланса, Relavio проверяет бесплатный месячный лимит API-запросов. Лимит задается активным бесплатным тарифом.

Если бесплатный лимит исчерпан, API вернет HTTP 402 Payment Required.

json
{
  "message": "Free monthly API request limit exceeded. Top up your balance to continue with pay-as-you-go billing."
}

Pay-as-you-go ​

Если баланс положительный, включается режим оплаты по фактическому использованию. Запросы оплачиваются с баланса по ставке тарифа Pay-as-you-go.

Списание за API-запросы происходит блоками по 1000 запросов. Если на балансе недостаточно средств для очередного списания, API вернет 402 Payment Required.

json
{
  "message": "Insufficient balance for pay-as-you-go API request."
}

Импорты товаров ​

Импорты также учитывают лимиты и баланс.

Если нет положительного баланса, действует бесплатный дневной лимит импортов. Если баланс положительный, импорт оплачивается по количеству товаров в фиде.

При недостаточном балансе импорт может завершиться ошибкой.

Как посмотреть лимиты ​

  1. Откройте личный кабинет Relavio.
  2. Перейдите в Тариф и оплата.
  3. Проверьте блок с балансом, API-запросами за период и импортами за день.
  4. Посмотрите карточки тарифов ниже.

Подробнее: Лимиты аккаунта.

Как уменьшить расход запросов ​

  • Не отправляйте поисковый запрос на каждый символ без debounce.
  • Используйте готовый виджет: в нем уже есть задержка перед запросом.
  • Не запускайте поиск, если строка слишком короткая.
  • Для каталога задавайте разумный per_page.
  • Кэшируйте результаты на своей стороне только там, где это не ухудшает актуальность.
  • Не используйте боевой API-ключ для массовых тестов.

Как виджет снижает лишние запросы ​

Стандартный виджет Relavio Search:

  • использует задержку перед отправкой запроса;
  • отменяет предыдущий запрос при новом вводе;
  • не запускает обычный поиск для коротких запросов меньше minLength;
  • догружает следующие страницы только при необходимости;
  • отправляет фильтры только в режиме catalog-with-filters.

Что делать при ошибке 402 ​

Если API вернул 402 Payment Required:

  1. Проверьте баланс аккаунта.
  2. Проверьте месячное использование API.
  3. Пополните баланс в разделе Тариф и оплата.
  4. Убедитесь, что запросы не отправляются слишком часто.
  5. Повторите запрос после пополнения.

Рекомендации для продакшена ​

  • Следите за количеством API-запросов после запуска виджета.
  • Проверяйте историю поиска и аналитику, чтобы понимать реальную активность пользователей.
  • Настройте корректное расписание импортов: не чаще, чем обновляется каталог.
  • Держите небольшой запас баланса, если используете Pay-as-you-go.
  • Обрабатывайте 402 в собственных интеграциях, чтобы показывать понятное сообщение администратору.

Связанные разделы ​