docs: добавлено описание логики ограничителя запросов

Author: a-ulianov

readme.md

@@ -158,8 +158,9 @@ ProductInfoDescriptionRequest
 Для prod значения параметров могут быть увеличены.
 """
 
-product_list_limit = 10  # Кол-во товаров, выгружаемых за одну итерацию
-consumers_amount = 5     # Кол-во потребителей, выгружающих описания
+product_list_limit = 10     # Кол-во товаров, выгружаемых за одну итерацию
+consumers_amount = 5        # Кол-во потребителей, выгружающих описания
+consumers_rps_max_limit = 6 # Максимальное кол-во запросов в секунду для каждого потребителя
 queue_max_size = product_list_limit * consumers_amount  # Максимальный размер очереди
 
 product_descriptions = list()
@@ -214,6 +215,8 @@ async def consumer(queue):
             config=SellerAPIConfig(
                 # Понижаем уровень логирования
                 log_level="INFO",
+                # Ограничиваем кол-во запросов
+                max_requests_per_second=consumers_rps_max_limit
             )
     ) as api:
         while True:
@@ -306,8 +309,12 @@ config = SellerAPIConfig(
 )
 ```
 **💡 Обратите внимание:**
-*50 запросов в сек. — суммарное ограничение на все выполняемые запросы от всех методов с одного client_id в единицу времени.*
-*При этом у многих методов есть свои ограничения, которые не описаны документацией и могут меняться Ozon в зависимости от нагрузки на сервера.*
+- *Общий ограничитель запросов определен в `SellerAPIConfig.max_requests_per_second` и может быть переопределен в `.env` `OZON_SELLER_MAX_REQUESTS_PER_SECOND`.*
+- *Помимо общего ограничителя можно задавать ограничители запросов для каждого инстанса SellerAPI с помощью `max_requests_per_second`.*
+- *Если кол-во запросов по всем инстансам одного `client_id` или `token` превысит значение общего ограничителя, то будет применен общий ограничитель.*
+- *50 запросов в сек. — определенное документацией суммарное ограничение на все выполняемые запросы от всех методов с одного `client_id` в единицу времени.*
+- *При этом у многих методов есть свои ограничения, которые не описаны документацией и могут меняться Ozon в зависимости от нагрузки на сервера.*
+- *25-27 запросов в сек. - оптимальное значение для ненагруженных API-запросами кабинетов (получено экпериментальным путем).*
 
 
 ### Обработка ошибок и повторные попытки
@@ -335,9 +342,9 @@ config = SellerAPIConfig(
 
 ### Лимиты API
 
-Проект автоматически соблюдает [официальные лимиты Ozon API](https://docs.ozon.ru/api/seller/), но рекомендуется:
-- Использовать консервативные настройки лимитов
-- Мониторить статистику использования через встроенные методы
+Проект автоматически соблюдает [официальные лимиты Ozon API](https://docs.ozon.ru/api/seller/), но рекомендуется использовать консервативные настройки лимитов (оптимально 25-27 запросов в сек. в сумме)
+
+
 
 ## 🔧 Разработка